Appearance

Birth chart ​

http
POST /v1/birth-chart

Returns the complete Vedic birth chart — planet positions, house cusps, ascendant, moon sign, and nakshatra. Uses the Lahiri ayanamsha (sidereal).

Cost: 2 credits

Request body

FieldTypeRequired
profileIdstringYes

Example

bash
curl -X POST https://api.askvedicguru.com/api/v1/birth-chart \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{ "profileId": "683abc123def456" }'

Response

json
{
  "success": true,
  "data": {
    "ascendant": {
      "sign": "Gemini",
      "degree": 14.72,
      "nakshatra": "Ardra"
    },
    "moonSign": "Scorpio",
    "sunSign": "Taurus",
    "planets": [
      {
        "planet": "Sun",
        "sign": "Taurus",
        "degree": 29.41,
        "house": 12,
        "nakshatra": "Mrigashira",
        "isRetrograde": false
      },
      {
        "planet": "Moon",
        "sign": "Scorpio",
        "degree": 8.33,
        "house": 6,
        "nakshatra": "Anuradha",
        "isRetrograde": false
      }
    ],
    "houses": [
      { "house": 1, "sign": "Gemini", "degree": 14.72 },
      { "house": 2, "sign": "Cancer", "degree": 14.72 }
    ]
  }
}

Individual endpoints ​

For lighter payloads, fetch specific data points:

Planets only ​

http
POST /v1/planets

Returns only planet positions (same shape as planets array above). 2 credits.

Ascendant only ​

http
POST /v1/ascendant

Returns just the ascendant sign, degree, and nakshatra. 2 credits.

Rashi (moon sign) ​

http
POST /v1/rashi

Returns the moon sign with interpretation. 2 credits.

Nakshatra ​

http
POST /v1/nakshatra

Returns birth nakshatra, pada, ruling planet, and qualities. 2 credits.

Elemental profile ​

http
POST /v1/elements

Returns the balance of fire, earth, air, and water elements across the chart. 2 credits.

Basic details ​

http
POST /v1/basic-details

Returns a summary: moon sign, ascendant, sun sign, nakshatra, current dasha, and prominent yogas. 2 credits.