API documentation

Every endpoint, with the exact request body and an example response, captured from a live server for most of them. Send your key in the X-API-Key header. One successful call costs one credit, whatever you ask for in it — except the two PDF reports and the chat endpoint, which cost 25.

https://api.occultapi.com

Get an API key Error reference Open in Postman

What these endpoints produce

Interfaces built on the API. The endpoint behind each is named on the card.

Birth charts, drawn for you

North and South Indian diagrams with planets placed by sign, plus the positions table behind them. Ask for the SVG and the markup comes back with the JSON.

/api/astro/chart/

Daily panchang

Tithi, nakshatra, yoga and karana with their exact transition times, alongside sunrise, sunset, moonrise and moonset for any place and date.

/api/astro/panchanga/

Month at a glance

A full month of tithi, sunrise, sunset, moon sign and nakshatra per day, with festivals marked on the dates they fall — the whole grid from one call.

/api/astro/monthly_panchang/

299 endpoints, 330 searchable features

AI & chat

POSTAstrology chat

/api/astro/chat/

PDF reports

POSTHoroscope PDF report

/api/astro/pdf/horoscope/

POSTYear Book PDF report

/api/astro/pdf/yearbook/

Panchang

POSTBirth panchanga readings (your elements)

/api/astro/birth-panchanga-effects/

POSTChandrabala

/api/astro/chandrabala/

POSTDay and night length

/api/astro/day-night-length/

POSTDisha shool

/api/astro/disha-shool/

/api/astro/karana/

POSTKarana scan

/api/astro/karana_scan/

POSTLunar month

/api/astro/lunar-month/

POSTLunar phase

/api/astro/lunar-phase/

POSTLunar month scan

/api/astro/lunar_month_scan/

/api/astro/nakshatra/

/api/astro/nitya-yoga/

/api/astro/panchak/

POSTPanchang (five limbs)

/api/astro/panchang/

POSTBirth panchanga effects (reference table)

/api/astro/panchang_element_birth_effect/13 features

POSTPanchanga element names

/api/astro/panchanga-elements/

/api/astro/panchanga/57 features

POSTPanchanga yogas

/api/astro/panchanga_yogas/

POSTSamvat years

/api/astro/samvat/

POSTSankranti dates

/api/astro/sankranti/

/api/astro/tarabala/

/api/astro/tithi/

POSTTithi year scan

/api/astro/tithi_scan/

POSTNitya Yoga year scan

/api/astro/yoga_scan/

Muhurta & timings

POSTAbhijit muhurat

/api/astro/abhijit-muhurat/

POSTWeekday activities

/api/astro/activities_day_of_week/2 features

/api/astro/amrit-kaal/

POSTAuspicious timings

/api/astro/auspicious-timings/

POSTBrahma muhurat

/api/astro/brahma-muhurat/

/api/astro/choghadiya/

/api/astro/durmuhurat/

POSTPlanetary hours (hora)

/api/astro/hora/

POSTInauspicious timings

/api/astro/inauspicious-timings/

POSTCeremony muhurats

/api/astro/muhurat/1 feature

POSTMuhurta table

/api/astro/muhurta-table/

/api/astro/rahu-kaal/

POSTRavi yoga windows

/api/astro/ravi_yoga/

POSTSandhya windows

/api/astro/sandhya/

POSTAgni vasa and Shiva vasa

/api/astro/vasa-segments/

Sunrise & moonrise

POSTMoonrise and moonset

/api/astro/moonrise/

POSTSunrise and sunset

/api/astro/sunrise/

Lunar

POSTLunar mansions

/api/astro/lunar/mansions/

POSTVoid of course Moon

/api/astro/lunar/void-of-course/

POSTMoon illumination and phase

/api/astro/moon-illumination/

Calendars

POSTAssamese calendar

/api/astro/assamese_calendar/

POSTBengali calendar

/api/astro/bengali_calendar/

POSTGujarati calendar

/api/astro/gujarati_calendar/

POSTISKCON calendar

/api/astro/iskcon_calendar/

POSTKannada calendar

/api/astro/kannada_calendar/

POSTMalayalam calendar

/api/astro/malayalam_calendar/

POSTMarathi calendar

/api/astro/marathi_calendar/

POSTMonthly panchang

/api/astro/monthly_panchang/

POSTNepali calendar

/api/astro/nepali_calendar/

POSTOdia calendar

/api/astro/odia_calendar/

POSTOnam calendar

/api/astro/onam_calendar/

POSTTamil calendar

/api/astro/tamil_calendar/

POSTTelugu calendar

/api/astro/telugu_calendar/

Festivals & vrats

POSTHindu festivals (calculated for a place)

/api/astro/festival/1 feature

POSTFestival calendar (precomputed)

/api/festivals/

POSTVrat and upavas

/api/vrat-upavas/

Birth chart & houses

POSTChart attributes

/api/astro/attributes/

POSTBhava cusps

/api/astro/bhava-cusps/

POSTBirth chart

/api/astro/chart/

POSTChart analysis

/api/astro/chart_analysis/

POSTHouse lord placements (all 144)

/api/astro/effect_house_lord_different_house/1 feature

POSTHouse cusps

/api/astro/house/7 features

POSTHouse relationships

/api/astro/house_hora/29 features

POSTHouse significations

/api/astro/house_information/1 feature

POSTHouse lord placement (one pair)

/api/astro/house_lord_particular_house/1 feature

POSTSpecial lagnas

/api/astro/lagna/

POSTPart of Fortune

/api/astro/part-of-fortune/

Divisional charts

/api/astro/rashi/

POSTHora chart (D2)

/api/astro/hora-chart/

POSTDrekkana (D3)

/api/astro/drekkana/

POSTChaturthamsa (D4)

/api/astro/chaturthamsa/

POSTPanchamsa (D5)

/api/astro/panchamsa/

POSTShashthamsa (D6)

/api/astro/shashthamsa/

POSTSaptamsa (D7)

/api/astro/saptamsa/

POSTAshtamsa (D8)

/api/astro/ashtamsa/

POSTNavamsa (D9)

/api/astro/navamsa/

POSTDasamsa (D10)

/api/astro/dasamsa/

POSTRudramsa (D11)

/api/astro/rudramsa/

POSTDwadasamsa (D12)

/api/astro/dwadasamsa/

POSTShodasamsa (D16)

/api/astro/shodasamsa/

POSTVimsamsa (D20)

/api/astro/vimsamsa/

POSTChaturvimsamsa (D24)

/api/astro/chaturvimsamsa/

POSTNakshatramsa (D27)

/api/astro/nakshatramsa/

POSTTrimsamsa (D30)

/api/astro/trimsamsa/

POSTKhavedamsa (D40)

/api/astro/khavedamsa/

POSTAkshavedamsa (D45)

/api/astro/akshavedamsa/

POSTShashtyamsa (D60)

/api/astro/shashtyamsa/

POSTNavnavamsa (D81)

/api/astro/navnavamsa/

POSTAstottaramsa (D108)

/api/astro/astottaramsa/

POSTDwadasdwadasamsa (D144)

/api/astro/dwadasdwadasamsa/

Jaimini

POSTArgala and virodhargala

/api/astro/argala/

POSTChara karakas (Jaimini)

/api/astro/chara-karakas/

POSTKarakamsa (swamsa)

/api/astro/karakamsa/

POSTLongevity factors

/api/astro/longevity-factors/

POSTWhat a sign aspects

/api/astro/rashi-aspects/

KP (Krishnamurti Paddhati)

POSTKP chart (cusps, signs and planets)

/api/astro/kp-chart/

Chakras

POSTSarvatobhadra chakra

/api/astro/sarvatobhadra/

Planets & positions

GETAyanamsa value

/api/astro/ayanamsa_value/

POSTCelestial positions

/api/astro/celestial/31 features

POSTWhat a planet aspects

/api/astro/planet-aspects/

POSTPlanet equatorial coordinates

/api/astro/planet-equatorial/

POSTNatural planetary friendships

/api/astro/planet-friendships/

POSTPlanet horizon coordinates

/api/astro/planet-horizon/

POSTPlanet positions

/api/astro/planet-positions/

POSTPlanet placement readings

/api/astro/planet_insights/3 features

POSTFixed stars

/api/astro/star/10 features

/api/astro/upagraha/

POSTPlanetary details

/api/planetary_details/

Strength (bala)

POSTIshta phala

/api/astro/ishta-kashta-phala/

POSTKaala bala components

/api/astro/kaala-bala-components/

POSTShadbala and planetary strength

/api/astro/strength/50 features

POSTVarga and positional strength

/api/astro/varga-bala/

Ashtakavarga

POSTAshtakavarga

/api/astro/ashtakvarga/8 features

POSTPrastara ashtakavarga

/api/astro/ashtakvarga/prastara/

POSTAshtakavarga sodhana and pindas

/api/astro/ashtakvarga/sodhana/

POSTBhinnashtakavarga

/api/astro/bhinnashtakavarga/

POSTSarvashtakavarga

/api/astro/sarvashtakavarga/

Dashas — nakshatra (planet)

POSTAshtottari dasha

/api/astro/dasha/ashtottari/

POSTBudhi Gati dasha

/api/astro/dasha/budhi-gati/

POSTChaturaseeti Sama dasha

/api/astro/dasha/chaturaseeti-sama/

POSTDwadashottari dasha

/api/astro/dasha/dwadashottari/

POSTDwisaptati Sama dasha

/api/astro/dasha/dwisaptati/

POSTNakshatra dasha (any system)

/api/astro/dasha/nakshatra/

POSTPanchottari dasha

/api/astro/dasha/panchottari/

POSTSataabdika dasha

/api/astro/dasha/sataabdika/

POSTShattrimsa Sama dasha

/api/astro/dasha/shattrimsa-sama/

POSTShodashottari dasha

/api/astro/dasha/shodashottari/

POSTVimshottari dasha

/api/astro/dasha/vimshottari/

POSTYogini dasha

/api/astro/dasha/yogini/

Dashas — rashi (Jaimini)

POSTBrahma dasha

/api/astro/dasha/brahma/

POSTChakra dasha

/api/astro/dasha/chakra/

POSTChara dasha

/api/astro/dasha/chara/

/api/astro/dasha/drig/

POSTKalachakra dasha

/api/astro/dasha/kalachakra/

POSTKendradhi dasha

/api/astro/dasha/kendradhi/

POSTLagnamsaka dasha

/api/astro/dasha/lagnamsaka/

POSTMandooka dasha

/api/astro/dasha/mandooka/

POSTNarayana dasha

/api/astro/dasha/narayana/

POSTNavamsa dasha

/api/astro/dasha/navamsa/

POSTNirayana Shoola dasha

/api/astro/dasha/nirayana-shoola/

POSTParyaaya dasha

/api/astro/dasha/paryaaya/

POSTRashi dasha (any system)

/api/astro/dasha/rashi/

POSTSandhya dasha

/api/astro/dasha/sandhya/

POSTShoola dasha

/api/astro/dasha/shoola/

POSTSthira dasha

/api/astro/dasha/sthira/

POSTSudasa dasha

/api/astro/dasha/sudasa/

POSTTara Lagna dasha

/api/astro/dasha/tara-lagna/

POSTTrikona dasha

/api/astro/dasha/trikona/

POSTYogardha dasha

/api/astro/dasha/yogardha/

Dasha tools

POSTCurrent dasha

/api/astro/dasha/current/

POSTDasha drill-down

/api/astro/dasha/drill/

POSTDasha systems index

/api/astro/dasha/systems/

POSTDasha applicability

/api/astro/dasha_applicability/1 feature

Yogas & doshas

POSTCombination yogas

/api/astro/combination_yoga/

/api/astro/dosha/10 features

POSTKala Sarpa yoga

/api/astro/kalsarp/

/api/astro/raja_yoga/1 feature

Lal Kitab

POSTLal Kitab chart

/api/astro/lal-kitab/chart/

POSTLal Kitab chart layout

/api/astro/lal-kitab/horoscope/

POSTLal Kitab houses

/api/astro/lal-kitab/houses/

POSTLal Kitab planets

/api/astro/lal-kitab/planets/

POSTLal Kitab varshphal

/api/astro/lal-kitab/varshphal/

Matching & compatibility

POSTAshtakoota (Gun Milan) matching

/api/astro/ashtakoota/25 features

POSTPartner star search

/api/astro/compatibility_match/

POSTMarriage matching

/api/astro/horoscope-match/

POSTNaadi marriage yogas

/api/astro/naadi_marriage_prediction/1 feature

POSTPorutham (South Indian matching)

/api/astro/porutham/

Transits & annual charts

POSTTransit over natal planet

/api/astro/planet_transit_natal_planets/1 feature

POSTTransit over house

/api/astro/planet_transit_over_house/1 feature

POSTSaturn transit phases

/api/astro/shani_analysis/

POSTTransit crossings

/api/astro/transit/8 features

POSTTransit snapshot

/api/astro/transit/details/

POSTMoon crossing

/api/astro/transit/moon-crossing/

POSTLunar node crossing

/api/astro/transit/node-crossing/

POSTPlanet at a degree

/api/astro/transit/planet-at-degree/

POSTSolar ingress

/api/astro/transit/solar-ingress/

Tajika & varshaphala

POSTHarsha bala (Tajika)

/api/astro/harsha-bala/

POSTMudda dasha (varsha vimshottari)

/api/astro/mudda-dasha/

POSTMuntha (varshaphal)

/api/astro/muntha/

POSTPancha vargeeya bala

/api/astro/pancha-vargeeya-bala/

POSTPatyayini dasha

/api/astro/patyayini_dasha/1 feature

POSTSahams (Arabic Parts)

/api/astro/sahams/

POSTTajika annual charts

/api/astro/tajika/

POSTTajika aspects

/api/astro/tajika/aspects/

POSTTajika yogas

/api/astro/tajika/yogas/

Scans & transitions

POSTCombustion periods

/api/astro/combustion/

POSTNakshatra transitions

/api/astro/nakshatra_transitions/

POSTRetrograde periods

/api/astro/retrograde/

POSTSign transitions

/api/astro/sign_transitions/

Predictions & readings

POSTGeneral predictions

/api/astro/general_prediction/1 feature

POSTSign in house readings

/api/astro/rashi_in_house_insights/1 feature

POSTRashifal forecasts

/api/astro/rashifal/4 features

POSTRashifal today

/api/astro/rashifal/daily/

POSTRashifal this month

/api/astro/rashifal/monthly/

POSTRashifal tomorrow

/api/astro/rashifal/tomorrow/

POSTRashifal this week

/api/astro/rashifal/weekly/

POSTRashifal this year

/api/astro/rashifal/yearly/

POSTRashifal yesterday

/api/astro/rashifal/yesterday/

Prashna

GETPanchashalaka chakra

/api/astro/panchashalaka_chakra/

GETPanchashalaka vedha lookup

/api/astro/panchashalaka_vedha/

POSTPrashna sensitive points

/api/astro/prashna/

POSTAshtamangala Prashna

/api/astro/prashna/ashtamangala/

POSTJamakkol Prashna chart

/api/astro/prashna/jamakkol/

GETSaptashalaka chakra

/api/astro/saptashalaka_chakra/

GETSaptashalaka vedha lookup

/api/astro/saptashalaka_vedha/

Tarot

POSTTarot deck reference

/api/astro/tarot/deck/

/api/astro/tarot/draw/

POSTTarot spread

/api/astro/tarot/spread/

POSTTarot yes or no

/api/astro/tarot/yes-no/

Pancha Pakshi

POSTPancha Pakshi (bird activity by hora)

/api/astro/pancha_pakshi_hora/4 features

POSTPancha Pakshi (day in ten yamas)

/api/panchpakshi/

Returns

POSTLunar return

/api/astro/return/lunar/

POSTPlanetary return

/api/astro/return/planet/

POSTSaturn return

/api/astro/return/saturn/

POSTSolar return

/api/astro/return/solar/

POSTReturn to a degree

/api/astro/return/to-degree/

Eclipses

POSTEclipse attributes at a moment

/api/astro/eclipse/attributes/

POSTLocal eclipse visibility

/api/astro/eclipse/local/

POSTNext lunar eclipse

/api/astro/eclipse/next-lunar/

POSTNext solar eclipse

/api/astro/eclipse/next-solar/

POSTEclipses in a date range

/api/astro/eclipse/range/

POSTUpcoming eclipses

/api/astro/eclipse/upcoming/

POSTEclipse visibility path

/api/astro/eclipse/visibility-path/

Mundane astrology

POSTMundane ingress charts

/api/astro/mundane-charts/

POSTMundane astrology

/api/astro/mundane/24 features

POSTPlanetary conjunctions

/api/astro/mundane/conjunctions/

POSTSky events timeline

/api/astro/mundane/events/

POSTSign ingresses

/api/astro/mundane/ingresses/

POSTNew and full moons

/api/astro/mundane/lunations/

POSTRetrograde stations

/api/astro/mundane/stations/

POSTMundane nakshatra chakras

/api/astro/nakshatra-chakras/

POSTRulers of the Hindu year

/api/astro/samvatsara/

POSTEquinoxes, solstices and ritus

/api/astro/seasons/

Fixed stars

POSTFixed star catalogue

/api/astro/fixed-star/catalog/

POSTStars on your chart

/api/astro/fixed-star/conjunctions/

POSTStar and planet parans

/api/astro/fixed-star/parans/

POSTFixed star positions

/api/astro/fixed-star/positions/

Traditional & Hellenistic

POSTCazimi, combustion and under the beams

/api/astro/cazimi/

/api/astro/traditional/almuten/

POSTEssential dignities

/api/astro/traditional/dignities/

POSTProfections

/api/astro/traditional/profections/

/api/astro/traditional/sect/

Western astrology

POSTAntiscia and contra-antiscia

/api/astro/western/antiscia/

POSTComposite chart

/api/astro/western/composite/

POSTDavison relationship chart

/api/astro/western/davison/

POSTDraconic chart

/api/astro/western/draconic/

POSTHarmonic chart

/api/astro/western/harmonic/

POSTHeliocentric chart

/api/astro/western/heliocentric/

POSTWestern house cusps

/api/astro/western/house-cusps/

POSTWestern natal chart

/api/astro/western/natal-chart/

POSTWestern planets (tropical)

/api/astro/western/planets/

POSTSecondary progressions

/api/astro/western/progressions/

/api/astro/western/synastry/

POSTTransits to natal

/api/astro/western/transits/

Numerology

/api/astro/numerology/34 features

POSTAbjad numerals

/api/astro/numerology/abjad/

POSTAngel numbers

/api/astro/numerology/angel/

POSTAura numerology

/api/astro/numerology/aura/

POSTChaldean numerology

/api/astro/numerology/chaldean/

POSTCheiro numerology

/api/astro/numerology/cheiro/

POSTChinese numerology

/api/astro/numerology/chinese/

POSTHebrew gematria

/api/astro/numerology/gematria/

POSTI Ching numerology

/api/astro/numerology/iching/

POSTGreek isopsephy

/api/astro/numerology/isopsephy/

POSTKabbalah numerology

/api/astro/numerology/kabbalah/

POSTPythagorean numerology

/api/astro/numerology/pythagorean/

POSTSepharial numerology

/api/astro/numerology/sepharial/

POSTTarot numerology

/api/astro/numerology/tarot/

POSTVedic numerology

/api/astro/numerology/vedic/

Chinese astrology

POSTBaZi chart with ten gods

/api/astro/chinese/bazi/

POSTChinese Four Pillars (BaZi)

/api/astro/chinese/four-pillars/

POSTChinese luck pillars (da yun)

/api/astro/chinese/luck-pillars/

POSTChinese zodiac sign

/api/astro/chinese/zodiac/

Astrocartography

POSTAstrocartography lines

/api/astro/astrocartography/lines/

POSTLocal space lines

/api/astro/astrocartography/local-space/

POSTParan crossings

/api/astro/astrocartography/parans/

POSTLines near a place

/api/astro/astrocartography/relocate/

Human Design

POSTHuman Design bodygraph

/api/astro/human-design/chart/

POSTConnection chart

/api/astro/human-design/connection/

POSTType, strategy and authority

/api/astro/human-design/properties/

Hazard events

GETEarthquake events

/api/hazard/earthquake/

GETForest fires

/api/hazard/forest-fires/

GETPlane crashes

/api/hazard/plane-crashes/

GETSuicide attacks

/api/hazard/suicide-attacks/

GETTsunami events

/api/hazard/tsunami/events/

Utilities

POSTTime zone resolver

/api/astro/date_time/

GETPlace lookup

/api/astro/geocode/

POSTText translation

/api/astro/translate/

Astrology

POSTAscendant (rising sign / Lagna) calculator

/api/astro/ascendant/

prashnavali

POSTHanuman Prashnavali

/api/astro/prashnavali/hanuman/

POSTMavji Maharaj Prashnavali

/api/astro/prashnavali/mavji/

POSTRam Shalaka Prashnavali

/api/astro/prashnavali/ram-shalaka/

POSTSai Prashnavali

/api/astro/prashnavali/sai/

Error reference

Status	Code	What it means	What to do
401	invalid_api_key	The key is wrong, revoked or expired.	Check the X-API-Key header. If you rotated, deploy the new key.
402	insufficient_credits	The key is valid — you are out of credits.	Upgrade your plan or wait for the monthly reset. Not an auth problem; do not regenerate your key.
403	endpoint_not_allowed	That route is not available to API keys: the path or method is wrong, or the endpoint has been retired.	Check the route and method against the reference. Retrying will not help.
403	scope_not_allowed	Your key lacks the scope this endpoint needs.	Create a key with the right scopes, or leave scopes empty for all.
403	ip_not_allowed	The key has an IP allowlist and this request came from another address.	Call from an allowed IP, or create a key with the right IPs.
403	account_suspended	The account is suspended, so all of its keys are refused.	Contact support. A new key will not help.
429	api_key_rate_limited	Too many requests in one minute.	Back off and retry after the seconds in Retry-After.
400	(field errors)	Your request body was wrong.	Read message; it names each field. Never charged.