/api/astro/sarvatobhadra/1 creditSarvatobhadra chakra
The nine-by-nine board used to judge transits, with the grahas placed on it and the vedha (piercing) worked out. The twenty-eight nakshatras — the usual twenty-seven plus Abhijit — sit around the outer ring in a fixed order that starts at Krittika and runs clockwise, NOT in the plain nakshatra sequence. The inner cells carry the twelve signs, the seven weekdays and a set of syllables. A graha standing in a nakshatra pierces the cell facing it across the board. The whole 9×9 grid comes back alongside the placements, so you can draw the chakra rather than only read a verdict from it. Each cell says what it holds and whether it is on the ring. Pass `transit_date_time` to place the transiting grahas on the same board — that is what the chakra is actually for. `hits_natal` then lists the transiting grahas whose vedha falls on a nakshatra your natal chart occupies. `rule` states which vedha rule was applied. Only positional vedha is used: top row pierces bottom in the same column, left column pierces right in the same row. Schools that add diagonal, tithi or vaara vedha will differ, and rather than pick one silently the rule is named in every response. A nakshatra spelling that cannot be resolved to a cell is returned under `unplaced` rather than dropped, so a graha never goes quietly missing from the board.
https://api.occultapi.com/api/astro/sarvatobhadra/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 |
|---|---|---|---|
| date_time | 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, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers. |
| 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 -90 · max 90 |
| 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 |
| ayanamsa | string | optional | |
| timezone_as_float | number (double) | optional | UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30), -5 for New York in winter, 5.75 for Nepal. This is NOT validated against date_time - if the two disagree you get a successful response for the wrong moment, so derive both from the same source. Use the offset in force on that date, not today's: a summer birth in a country with daylight saving needs the summer offset. min -12 · max 14 |
| transit_date_time | string (date-time) | optional | Optional. When given, the transiting grahas for this moment are placed on the chakra alongside the natal ones, which is what the chakra is actually read for. |
Example request
curl -X POST https://api.occultapi.com/api/astro/sarvatobhadra/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Response
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"system\": \"sarvatobhadra\", \"size\": 9, \"palette\": {\"W\": \"#ffffff\", \"C\": \"#FFEFD8\", \"L\": \"#CEE1F6\", \"D\": \"#A7CDFA\", \"border\": \"#C0CCDF\", \"frame\": \"#5D636C\", \"layer1\": \"#E8F1FB\", \"layer2\": \"#F9FAFB\", \"text\": \"#374151\"}, \"grid\": [[{\"row\": 0, \"column\": 0, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"अ\", \"ring\": false, \"shade\": \"W\", \"colour\": \"#ffffff\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 0, \"column\": 1, \"nakshatra\": \"Krittika\", \"nakshatra_key\": \"krittika\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"अ\", \"इ\", \"उ\", \"ए\"], \"short_name\": \"Kritika\", \"side\": \"top\"}, {\"row\": 0, \"column\": 2, \"nakshatra\": \"Rohini\", \"nakshatra_key\": \"rohini\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"ओ\", \"व\", \"वी\", \"वू\"], \"short_name\": \"Rohini\", \"side\": \"top\"}, {\"row\": 0, \"column\": 3, \"nakshatra\": \"Mrigashira\", \"nakshatra_key\": \"mrigashira\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"वे\", \"वो\", \"क\", \"की\"], \"short_name\": \"Mrigashi\", \"side\": \"top\"}, {\"row\": 0, \"column\": 4, \"nakshatra\": \"Ardra\", \"nakshatra_key\": \"ardra\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"कु\", \"घ\", \"ङ\", \"छ\"], \"short_name\": \"Ardra\", \"side\": \"top\"}, {\"row\": 0, \"column\": 5, \"nakshatra\": \"Punarvasu\", \"nakshatra_key\": \"punarvasu\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"के\", \"को\", \"ह\", \"ही\"], \"short_name\": \"Punarvasu\", \"side\": \"top\"}, {\"row\": 0, \"column\": 6, \"nakshatra\": \"Pushya\", \"nakshatra_key\": \"pushya\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"हु\", \"हे\", \"हो\", \"ड\"], \"short_name\": \"Pushya\", \"side\": \"top\"}, {\"row\": 0, \"column\": 7, \"nakshatra\": \"Ashlesha\", \"nakshatra_key\": \"ashlesha\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"डी\", \"डू\", \"डे\", \"डो\"], \"short_name\": \"Ashlesha\", \"side\": \"top\"}, {\"row\": 0, \"column\": 8, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"आ\", \"ring\": false, \"shade\": \"W\", \"colour\": \"#ffffff\", \"padas\": null, \"short_name\": null, \"side\": null}], [{\"row\": 1, \"column\": 0, \"nakshatra\": \"Bharani\", \"nakshatra_key\": \"bharani\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"ली\", \"लू\", \"ले\", \"लो\"], \"short_name\": \"Bharani\", \"side\": \"left\"}, {\"row\": 1, \"column\": 1, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"उ\", \"ring\": false, \"shade\": \"W\", \"colour\": \"#ffffff\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 2, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"अ\", \"ring\": false, \"shade\": \"D\", \"colour\": \"#A7CDFA\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 3, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"व\", \"ring\": false, \"shade\": \"D\", \"colour\": \"#A7CDFA\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 4, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"क\", \"ring\": false, \"shade\": \"D\", \"colour\": \"#A7CDFA\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 5, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"द\", \"ring\": false, \"shade\": \"D\", \"colour\": \"#A7CDFA\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 6, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"ह\", \"ring\": false, \"shade\": \"D\", \"colour\": \"#A7CDFA\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 7, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"ऊ\", \"ring\": false, \"shade\": \"W\", \"colour\": \"#ffffff\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 8, \"nakshatra\": \"Magha\", \"nakshatra_key\": \"magha\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"म\", \"मी\", \"मू\", \"मे\"], \"short_name\": \"Magha\", \"side\": \"right\"}], [{\"row\": 2, \"column\": 0, \"nakshatra\": \"Ashwini\", \"nakshatra_key\": \"ashwini\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"चू\", \"चे\", \"चो\", \"ला\"], \"short_name\": \"Ashwini\", \"side"
}Captured from a real call using the exact request above. Results sit under data.
Errors
Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.