/api/astro/nakshatra_transitions/1 creditNakshatra transitions
Every planet's movement from one nakshatra to the next across a calendar year, with each crossing resolved to about a second. This is the 'planet nakshatra gochar' table: when Saturn leaves Purva Bhadrapada, when Jupiter enters Pushya, when the Moon changes star — the events transit predictions are timed from. granularity chooses the resolution. 'nakshatra' uses the 13°20' divisions and returns from and to as plain names; 'pada' uses the 3°20' quarters and returns from and to as {nakshatra, pada} objects instead. Set use_28_nakshatras to true to include Abhijit as a twenty-eighth division. Pass year and timezone_as_float. The offset decides where the local year starts and ends, but the returned timestamps are UTC — convert them yourself for display. The response is {year, granularity, planets}, where planets is keyed by name (sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu, ketu), each holding a chronological list of {from, to, datetime}. The Moon alone produces over three hundred nakshatra transitions in a year and around fourteen hundred pada transitions, so pada responses are large.
https://api.occultapi.com/api/astro/nakshatra_transitions/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 |
|---|---|---|---|
| granularity | string | required | nakshatrapada |
| year | integer | required | Year of birth as a number, e.g. 1990. Four digits. min 1800 · max 2400 |
| 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. |
| use_28_nakshatras | boolean | optional |
Example request
curl -X POST https://api.occultapi.com/api/astro/nakshatra_transitions/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"granularity":"nakshatra","year":2026,"timezone_as_float":5.5}'Response
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"granularity\": \"nakshatra\", \"planets\": {\"jupiter\": [{\"from\": \"Punarvasu\", \"to\": \"Pushyami\", \"datetime\": \"2026-06-18 15:31:55\"}, {\"from\": \"Pushyami\", \"to\": \"Aasresha\", \"datetime\": \"2026-08-18 21:42:28\"}, {\"from\": \"Aasresha\", \"to\": \"Makha\", \"datetime\": \"2026-10-31 06:32:43\"}], \"sun\": [{\"from\": \"Poorvaashaadha\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-01-11 03:06:16\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-01-24 05:20:24\"}, {\"from\": \"Sravanam\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-02-06 08:35:04\"}, {\"from\": \"Dhanishtha\", \"to\": \"Satabhishak\", \"datetime\": \"2026-02-19 13:03:28\"}, {\"from\": \"Satabhishak\", \"to\": \"Poorvaabhaadra\", \"datetime\": \"2026-03-04 19:24:10\"}, {\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-03-18 03:51:12\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-03-31 14:40:06\"}, {\"from\": \"Revati\", \"to\": \"Ashwini\", \"datetime\": \"2026-04-14 04:02:39\"}, {\"from\": \"Ashwini\", \"to\": \"Bharani\", \"datetime\": \"2026-04-27 19:47:57\"}, {\"from\": \"Bharani\", \"to\": \"Krittika\", \"datetime\": \"2026-05-11 14:01:16\"}, {\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"2026-05-25 10:07:52\"}, {\"from\": \"Rohini\", \"to\": \"Mrigasira\", \"datetime\": \"2026-06-08 08:03:01\"}, {\"from\": \"Mrigasira\", \"to\": \"Aardra\", \"datetime\": \"2026-06-22 06:56:07\"}, {\"from\": \"Aardra\", \"to\": \"Punarvasu\", \"datetime\": \"2026-07-06 06:33:36\"}, {\"from\": \"Punarvasu\", \"to\": \"Pushyami\", \"datetime\": \"2026-07-20 05:58:19\"}, {\"from\": \"Pushyami\", \"to\": \"Aasresha\", \"datetime\": \"2026-08-03 04:54:24\"}, {\"from\": \"Aasresha\", \"to\": \"Makha\", \"datetime\": \"2026-08-17 02:28:46\"}, {\"from\": \"Makha\", \"to\": \"Poorva Phalguni\", \"datetime\": \"2026-08-30 22:29:09\"}, {\"from\": \"Poorva Phalguni\", \"to\": \"Uttara Phalguni\", \"datetime\": \"2026-09-13 16:17:57\"}, {\"from\": \"Uttara Phalguni\", \"to\": \"Hasta\", \"datetime\": \"2026-09-27 07:49:50\"}, {\"from\": \"Hasta\", \"to\": \"Chitra\", \"datetime\": \"2026-10-10 20:50:07\"}, {\"from\": \"Chitra\", \"to\": \"Swaati\", \"datetime\": \"2026-10-24 07:20:48\"}, {\"from\": \"Swaati\", \"to\": \"Visaakha\", \"datetime\": \"2026-11-06 15:33:21\"}, {\"from\": \"Visaakha\", \"to\": \"Anooraadha\", \"datetime\": \"2026-11-19 21:33:50\"}, {\"from\": \"Anooraadha\", \"to\": \"Jyeshtha\", \"datetime\": \"2026-12-03 01:58:15\"}, {\"from\": \"Jyeshtha\", \"to\": \"Moola\", \"datetime\": \"2026-12-16 04:55:02\"}, {\"from\": \"Moola\", \"to\": \"Poorvaashaadha\", \"datetime\": \"2026-12-29 07:14:19\"}], \"rahu\": [{\"from\": \"Satabhishak\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-08-01 21:41:47\"}], \"pluto\": [{\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-02-18 02:18:30\"}, {\"from\": \"Sravanam\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-07-29 15:00:03\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-12-28 01:39:54\"}], \"saturn\": [{\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-01-20 05:22:43\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-05-17 09:07:48\"}, {\"from\": \"Revati\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-10-09 15:21:10\"}], \"uranus\": [{\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"2026-07-11 23:54:01\"}, {\"from\": \"Rohini\", \"to\": \"Krittika\", \"datetime\": \"2026-11-12 10:52:56\"}], \"mars\": [{\"from\": \"Poorvaashaadha\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-01-11 15:40:42\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-01-28 19:08:49\"}, {\"from\": \"Sravanam\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-02-14 19:08:16\"}, {\"from\": \"Dhanishtha\", \"to\": \"Satabhishak\", \"datetime\": \"2026-03-03 17:24:52\"}, {\"from\": \"Satabhishak\", \"to\": \"Poorvaabhaadra\", \"datetime\": \"2026-03-20 15:51:47\"}, {\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-04-06 16:26:20\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-04-23 20:52:02\"}, {\"from\": \"Revati\", \"to\": \"Ashwini\", \"datetime\": \"2026-05-11 07:08:41\"}, {\"from\": \"Ashwini\", \"to\": \"Bharani\", \"datetime\": \"2026-05-29 00:55:31\"}, {\"from\": \"Bharani\", \"to\": \"Krittika\", \"datetime\": \"2026-06-16 04:02:43\"}, {\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"20"
}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.