POST/api/astro/chaturvimsamsa/1 credit

Chaturvimsamsa (D24)

The chaturvimsamsa, the twenty-fourth divisional chart, also called siddhamsa: each sign divided into twenty-four parts of 1°15' each. Read for education and learning - not the qualifications obtained but what is actually mastered. Returns the same flat shape as /api/astro/planet-positions/: the planets as a list in traditional order with `name`, longitude, sign, nakshatra, pada and house on each, plus the ascendant and the ayanamsa applied. The route pins the chart, so a `chart_name` in the body is ignored rather than honoured - this endpoint cannot return anything but this division.

https://api.occultapi.com/api/astro/chaturvimsamsa/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

Field	Type	Required	Notes
chart_name	string	required
datetime	string (date-time)	required	The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC. Same meaning as date_time, which other endpoints call the same thing by a different name.
latitude	number (double)	required	Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first. min -89.9 · max 89.9
longitude	number (double)	required	Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China. min -180 · max 180
aberration	boolean	optional
apply_correction	boolean	optional
ascendant_pos	string	optional	`cuspstartend`
ayanamsa	string	optional
background_color	string	optional	Hex color for the SVG background.
chart_style	string	optional	Diagram style when render='svg'. 'north' is the diamond layout with fixed houses and rotating signs; 'south' is the fixed-sign grid with rotating houses. `northsouth`
correction_deg	integer	optional	min 0
correction_direction	string	optional	`addsubtract`
correction_min	integer	optional	min 0 · max 59
correction_sec	integer	optional	min 0 · max 59
extended_bodies	array	optional	Body groups to include: 'asteroids', 'planetary_moons', 'fictitious_bodies'.
label_style	string	optional	How planets are labelled: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) or 'symbol' (☉, ☽, ...). `englishsanskritsymbol`
line_color	string	optional	Hex color for the chart's grid lines.
notation	string	optional	`astrologicaldegree`
nutation	boolean	optional
planet_color	string	optional	Hex color for planet labels, e.g. '#111827'. Defaults to the theme's own colour.
rahu	string	optional	Node type to include. 'true' returns true nodes only, 'mean' returns mean nodes only, 'both' returns both. `truemeanboth`
refraction	boolean	optional
render	string	optional	Set to 'svg' to also return a rendered chart diagram (see chart_style) and the geometry behind it. Omit this entirely and the response is unchanged. `nonesvg`
show_degrees	boolean	optional	Print each body's degree within its sign next to its label.
sign_color	string	optional	Hex color for sign numbers/abbreviations.
svg_size	integer	optional	Width and height of the square SVG viewBox, in pixels. min 100 · max 2000
theme	string	optional	`lightdark`
true_mean	string	optional	`TrueMean`
use_28_nakshatras	boolean	optional

Example request

This example is not yet verified

The field names and types below are taken from the API definition and are accurate, but this particular body has not returned a success when we last ran it — it may need a value we cannot infer. Treat it as a starting point rather than a working command.

curl -X POST https://api.occultapi.com/api/astro/chaturvimsamsa/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chart_name":"string","datetime":"2026-09-01 06:00:00","latitude":26.9124,"longitude":75.7873,"ascendant_pos":"cusp","chart_style":"north","correction_direction":"add","label_style":"english","notation":"astrological","rahu":"true","render":"none","theme":"light","true_mean":"True"}'

Response

A verified example response is not available for this endpoint yet. The request shape above is generated from the API definition and is accurate; we publish response samples only once we have proven them against a live call.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.