Field
year
Type
integer
Required
Yes
Description
Birth year.
Back to Docs
Basic Vedic Chart
Basic Vedic Chart
POST
/api/v2/vedic/chartCalculate the calibrated V2 sidereal D1 chart with ascendant, graha placements, houses, Nakshatras, and Sade Sati context.
Authentication: send x-api-key.
Full URL
https://api.freeastroapi.com/api/v2/vedic/chartSafe retries with Idempotency-Key
Authenticated, billable astrology POST requests accept the optional header Idempotency-Key: <client-generated unique operation key>. Reuse the same key only when retrying the exact same method, path, query string, and JSON body after a timeout or network failure.
A completed replay returns the first response with Idempotency-Replayed: true, does not rerun the calculation, and does not consume extra quota. Keys are retained for about 24 hours.
Reusing a key with a changed request returns 409 idempotency_key_reused. A duplicate while the first request is still running returns 409 request_in_progress with Retry-After.
What It Returns
A clean V2 chart payload built for production apps: ascendant, planets, houses, Sade Sati, and metadata that records the ayanamsha, house system, node type, timezone, and ruleset used.
Example Request
curl -X POST "https://api.freeastroapi.com/api/v2/vedic/chart" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"year": 1997,
"month": 9,
"day": 22,
"hour": 23,
"minute": 25,
"city": "Mumbai",
"lat": 19.391928,
"lng": 72.839732,
"tz_str": "Asia/Kolkata",
"ayanamsha": "lahiri",
"house_system": "whole_sign",
"node_type": "mean"
}'Request Parameters
Provide either city or both lat and lng. Coordinates are recommended for stable production results.
Field
month
Type
integer
Required
Yes
Description
Birth month (1-12).
Field
day
Type
integer
Required
Yes
Description
Birth day.
Field
hour
Type
integer
Required
Yes
Description
Birth hour (0-23).
Field
minute
Type
integer
Required
Yes
Description
Birth minute (0-59).
Field
city
Type
string
Required
No
Description
Birth city. Optional when lat/lng are provided.
Field
lat
Type
float
Required
No
Description
Birth latitude. Recommended for production.
Field
lng
Type
float
Required
No
Description
Birth longitude. Recommended for production.
Field
tz_str
Type
string
Required
No
Description
Optional timezone override such as Asia/Kolkata, Europe/London, AUTO, or LMT. Defaults to AUTO when omitted.
Field
ayanamsha
Type
string
Required
No
Description
Vedic ayanamsha. Default is lahiri.
Field
house_system
Type
string
Required
No
Description
House system. Default is whole_sign.
Field
node_type
Type
string
Required
No
Description
Lunar node type: mean or true.
Field
include_avastha
Type
boolean
Required
No
Description
Include Baladi Avastha planet age state on each planet.
Response Shape
Field
ascendant
Type
object
Required
n/a
Description
Sidereal ascendant sign, degree, and Nakshatra context.
Field
planets
Type
array
Required
n/a
Description
Graha positions with sign, house, Nakshatra, pada, retrograde state, and absolute degree.
Field
planets[].avastha
Type
object
Required
n/a
Description
Optional Baladi Avastha age state when include_avastha is true.
Field
houses
Type
array
Required
n/a
Description
House/sign mapping for the selected house system.
Field
sade_sati
Type
object
Required
n/a
Description
Current Sade Sati status computed from the chart context.
Field
metadata
Type
object
Required
n/a
Description
Endpoint version, ruleset version, ayanamsha, house system, node type, and timezone used.
Real Request Example
This request was captured from the live production endpoint and is the same payload used in the code tabs.
{
"year": 1997,
"month": 9,
"day": 22,
"hour": 23,
"minute": 25,
"city": "Mumbai",
"lat": 19.391928,
"lng": 72.839732,
"tz_str": "Asia/Kolkata",
"ayanamsha": "lahiri",
"house_system": "whole_sign",
"node_type": "mean"
}Real Response Example
This is a real production response for the example payload. Large arrays are intentionally shown as returned by the API.
V2
{
"ascendant": {
"degree": 58.7441,
"sign": "Taurus",
"sign_id": 2,
"nakshatra": {
"id": 5,
"name": "Mrigashira",
"pada": 2,
"lord": "Mars"
}
},
"planets": [
{
"name": "Sun",
"absolute_degree": 155.9362,
"sign": "Virgo",
"sign_id": 6,
"degree_in_sign": 5.9362,
"house": 5,
"is_retrograde": false,
"nakshatra": "Uttara Phalguni",
"nakshatra_id": 12,
"pada": 3,
"nakshatra_lord": "Sun"
},
{
"name": "Moon",
"absolute_degree": 56.0529,
"sign": "Taurus",
"sign_id": 2,
"degree_in_sign": 26.0529,
"house": 1,
"is_retrograde": false,
"nakshatra": "Mrigashira",
"nakshatra_id": 5,
"pada": 1,
"nakshatra_lord": "Mars"
},
{
"name": "Mars",
"absolute_degree": 211.8965,
"sign": "Scorpio",
"sign_id": 8,
"degree_in_sign": 1.8965,
"house": 7,
"is_retrograde": false,
"nakshatra": "Vishakha",
"nakshatra_id": 16,
"pada": 4,
"nakshatra_lord": "Jupiter"
},
{
"name": "Mercury",
"absolute_degree": 139.8928,
"sign": "Leo",
"sign_id": 5,
"degree_in_sign": 19.8928,
"house": 4,
"is_retrograde": false,
"nakshatra": "Purva Phalguni",
"nakshatra_id": 11,
"pada": 2,
"nakshatra_lord": "Venus"
},
{
"name": "Jupiter",
"absolute_degree": 288.6611,
"sign": "Capricorn",
"sign_id": 10,
"degree_in_sign": 18.6611,
"house": 9,
"is_retrograde": true,
"nakshatra": "Shravana",
"nakshatra_id": 22,
"pada": 3,
"nakshatra_lord": "Moon"
},
{
"name": "Venus",
"absolute_degree": 198.4909,
"sign": "Libra",
"sign_id": 7,
"degree_in_sign": 18.4909,
"house": 6,
"is_retrograde": false,
"nakshatra": "Swati",
"nakshatra_id": 15,
"pada": 4,
"nakshatra_lord": "Rahu"
},
{
"name": "Saturn",
"absolute_degree": 354.4198,
"sign": "Pisces",
"sign_id": 12,
"degree_in_sign": 24.4198,
"house": 11,
"is_retrograde": true,
"nakshatra": "Revati",
"nakshatra_id": 27,
"pada": 3,
"nakshatra_lord": "Mercury"
},
{
"name": "Rahu",
"absolute_degree": 145.2107,
"sign": "Leo",
"sign_id": 5,
"degree_in_sign": 25.2107,
"house": 4,
"is_retrograde": true,
"nakshatra": "Purva Phalguni",
"nakshatra_id": 11,
"pada": 4,
"nakshatra_lord": "Venus"
},
{
"name": "Ketu",
"absolute_degree": 325.2107,
"sign": "Aquarius",
"sign_id": 11,
"degree_in_sign": 25.2107,
"house": 10,
"is_retrograde": true,
"nakshatra": "Purva Bhadrapada",
"nakshatra_id": 25,
"pada": 2,
"nakshatra_lord": "Jupiter"
}
],
"houses": [
{
"house": 1,
"sign": "Taurus",
"sign_id": 2,
"degree_cusp": 0
},
{
"house": 2,
"sign": "Gemini",
"sign_id": 3,
"degree_cusp": 0
},
{
"house": 3,
"sign": "Cancer",
"sign_id": 4,
"degree_cusp": 0
},
{
"house": 4,
"sign": "Leo",
"sign_id": 5,
"degree_cusp": 0
},
{
"house": 5,
"sign": "Virgo",
"sign_id": 6,
"degree_cusp": 0
},
{
"house": 6,
"sign": "Libra",
"sign_id": 7,
"degree_cusp": 0
},
{
"house": 7,
"sign": "Scorpio",
"sign_id": 8,
"degree_cusp": 0
},
{
"house": 8,
"sign": "Sagittarius",
"sign_id": 9,
"degree_cusp": 0
},
{
"house": 9,
"sign": "Capricorn",
"sign_id": 10,
"degree_cusp": 0
},
{
"house": 10,
"sign": "Aquarius",
"sign_id": 11,
"degree_cusp": 0
},
{
"house": 11,
"sign": "Pisces",
"sign_id": 12,
"degree_cusp": 0
},
{
"house": 12,
"sign": "Aries",
"sign_id": 1,
"degree_cusp": 0
}
],
"sade_sati": {
"active": false,
"phase": null,
"description": "Sade Sati not active"
},
"metadata": {
"endpoint_version": "v2",
"ruleset_version": "classical_chart_v1",
"ayanamsha": "lahiri",
"house_system": "whole_sign",
"node_type": "mean",
"timezone_used": "Asia/Kolkata"
}
}FAQ
Can the Vedic Chart API return Avastha planet age state?
Yes. Set include_avastha to true to add planets[].avastha with Baladi Avastha age state for each returned graha. The default response omits this field for backward compatibility.
Does this endpoint return Shadbala or Ishta/Kashta Phala?
No. Use the Vedic Strength endpoint for Shadbala. Ishta/Kashta Phala is not currently returned by the API.