/api/astro/navnavamsa/1 creditNavnavamsa (D81)
The navnavamsa, the eighty-first division - the navamsa OF the navamsa, which is what the name says: nava-navamsa. THE ENGINE CARRIES TWO READINGS OF D81 and this route serves the compounded one. The other divides the rashi straight into eighty-one parts and is reachable through /api/astro/chart/ with `chart_name: "NavnavamsaChart"`. They disagree for most planets - they are different charts, not two spellings of one. AT ROUGHLY 22' PER DIVISION, treat this as worth reading only when the birth time is genuinely known to the minute. 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/navnavamsa/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/jsonRequest 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/navnavamsa/ \
-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.