# LifeAstroAPI: full endpoint catalog

> LifeAstroAPI is a REST API for Vedic astrology and the Hindu calendar: panchang, festivals and vrats, kundli, dasha, kundli matching, muhurat, horoscopes, numerology, tarot and Western astrology.

Base URL: https://api.lifeastroapi.com
Auth: header "Authorization: Bearer <API key>" (free key at https://lifeastroapi.com/signup/)
Times: pass date (YYYY-MM-DD), time (HH:MM), tz (IANA name such as Asia/Kolkata), lat and lon.

- 311 REST endpoints under one API key, including 12 composed JSON and PDF report endpoints.
- Festival and vrat dates verified entry for entry against the printed panchang calendars of 14 cities on four continents (4,427 of 4,427 entries).
- Computed with the Swiss Ephemeris; Lahiri ayanamsa by default, other ayanamsas on request.
- Astronomy checked against NASA JPL Horizons and NASA eclipse data with a published, rerunnable script: planet positions median 0.05 arc-seconds, sunrise/sunset/moonrise within 10 seconds, all 44 eclipses of 2021–2030 found with the same type (lifeastroapi.com/accuracy/#astronomy).
- Location-aware: every calculation takes latitude, longitude and an IANA timezone, so results are correct outside India too.
- Narratives and names in 10+ languages, including Hindi and regional Indian languages.
- Open-source MCP server with 310 tools for Claude Desktop, Cursor, Codex and other MCP clients: github.com/ayanshulife/lifeastroapi-mcp.
- Official Node.js / TypeScript SDK on npm: `npm install lifeastroapi` (source: github.com/ayanshulife/lifeastroapi-node).
- Free tier: 1,500 credits a month, no card required. Paid plans from ₹999 / $29 a month; pay-as-you-go also available.

## Example requests
- Vedic Astrology API: GET https://api.lifeastroapi.com/v1/chart/planets?date=1990-01-15&time=10:30&tz=Asia/Kolkata&lat=19.076&lon=72.8777
- Panchang API: GET https://api.lifeastroapi.com/v1/panchang/advanced?date=2027-01-15&time=06:00&tz=Asia/Kolkata&lat=28.6139&lon=77.209
- Hindu Calendar & Festival API: GET https://api.lifeastroapi.com/v1/festivals/month?year=2027&month=10&lat=28.6139&lon=77.209&tz=Asia/Kolkata
- Kundli API: GET https://api.lifeastroapi.com/v1/chart/planets?date=1990-01-15&time=10:30&tz=Asia/Kolkata&lat=19.076&lon=72.8777
- Kundli Matching API: GET https://api.lifeastroapi.com/v1/milan/ashtakoota?boy.date=1990-01-15&boy.time=10:30&boy.tz=Asia/Kolkata&girl.date=1992-03-20&girl.time=08:15&girl.tz=Asia/Kolkata
- Horoscope API: GET https://api.lifeastroapi.com/v1/horoscope/daily?rashi=Mesha&date=2027-01-15
- Muhurat API: GET https://api.lifeastroapi.com/v1/muhurta/best-time?purpose=vivah&start_date=2027-01-01&end_date=2027-01-31&tz=Asia/Kolkata&lat=28.6139&lon=77.209
- Numerology API: GET https://api.lifeastroapi.com/v1/numerology/full?name=Arjun%20Mehta&dob=1990-01-15
- Tarot API: GET https://api.lifeastroapi.com/v1/tarot/spread?type=three
- Western Astrology API: GET https://api.lifeastroapi.com/v1/western/natal/chart?date=1990-01-15&time=10:30&tz=Asia/Kolkata&lat=19.076&lon=72.8777

## Panchang (29)
- GET /v1/panchang/tithi (10 credits): Lunar day (tithi) at moment with transition times. Params: date*, time*, tz*.
- GET /v1/panchang/nakshatra (10 credits): Nakshatra + pada + lord at moment.
- GET /v1/panchang/yoga (10 credits): Yoga with transition JD.
- GET /v1/panchang/karana (10 credits): Karana (half-tithi).
- GET /v1/panchang/vara (10 credits): Vedic weekday (vara) with lord.
- GET /v1/panchang/sunrise-sunset (10 credits): Sunrise and sunset JD for location.
- GET /v1/panchang/moonrise-moonset (10 credits): Moonrise and moonset JD.
- GET /v1/panchang/rahu-kaal (10 credits): Rahu Kaal interval for the day.
- GET /v1/panchang/yamaganda (10 credits): Yamaganda interval.
- GET /v1/panchang/gulika (10 credits): Gulika interval.
- GET /v1/panchang/abhijit (10 credits): Abhijit muhurta window.
- GET /v1/panchang/brahma-muhurat (10 credits): Brahma Muhurat window.
- GET /v1/panchang/pradosh-kaal (10 credits): Pradosh Kaal interval.
- GET /v1/panchang/hora (10 credits): Planetary hora ruling at moment.
- GET /v1/panchang/choghadiya (10 credits): Day + night Choghadiya schedule.
- GET /v1/panchang/durmuhurta (10 credits): Durmuhurta intervals.
- GET /v1/panchang/varjyam (10 credits): Varjyam window.
- GET /v1/panchang/amrit-kalam (10 credits): Amrit Kalam window.
- GET /v1/panchang/siddha-yoga (10 credits): Siddha Yoga check.
- GET /v1/panchang/panchaka (10 credits): Panchaka type (5-fold inauspicious).
- GET /v1/panchang/hindu-month (10 credits): Amanta/Purnimanta Hindu month.
- GET /v1/panchang/sankranti (10 credits): Next solar sankranti (sign ingress).
- GET /v1/panchang/summary (20 credits): Five panchang elements at sunrise plus sunrise and sunset, in one call.
- GET /v1/panchang/basic (20 credits): All 5 panchang elements + sunrise/sunset/moonrise/moonset + transition end-times — single call replaces 7 atomic calls. Params: date*, time*, tz*, lat*, lon*.
- GET /v1/panchang/advanced (30 credits): Complete daily panchang: all 5 elements + muhurta windows (Rahu Kaal/Gulika/Abhijit/Brahma Muhurat) + Choghadiya + Hindu month + Samvat + Disha Shool + Nak Shool + Moon Nivas + Panchang Yogas + same-day transitions. Params: date*, time*, tz*, lat*, lon*.
- GET /v1/panchang/lagna-table (20 credits): All 12 lagna (ascendant sign) rise-times for the day — shows when each zodiac sign rises on the eastern horizon.
- GET /v1/panchang/monthly (30 credits): Month panchang — one row per day (tithi, nakshatra, yoga, vara, sunrise, sunset). Add include=sheet for a complete printable Hindu calendar page: tithi/nakshatra/moon-sign end-times in "27:07+" notation, kshaya days, moonrise/moonset, Hindu month, Vikram/Shaka samvat, moon phase and every festival of each day. Validated against 14 printed panchang calendars. Params: year*, month*, lat*, lon*, alt, tz, include, locale, month_system.
- GET /v1/panchang/hora-dinman (10 credits): Fixed equal-length hora (dinman method) — 12 day + 12 night horas of exactly 60 minutes each, with planetary lord.
- GET /v1/panchang/nakshatra-prediction (10 credits): Daily prediction based on Tara Bala — computed from birth nakshatra vs today's Moon nakshatra, with health/work/relationships/finance/travel guidance. Params: date*, time*, tz*, lat*, lon*, birth_nak*.

## Chart (Kundli) (21)
- GET /v1/chart/planets (10 credits): All 9 planets with longitude/sign/nakshatra/pada/house.
- GET /v1/chart/planet/{name} (10 credits): Single planet detail.
- GET /v1/chart/ascendant (10 credits): Lagna (ascendant) sign + degree.
- GET /v1/chart/houses (10 credits): Whole-sign house cusps.
- GET /v1/chart/divisional/{varga} (20 credits): Divisional chart D1 through D60.
- GET /v1/chart/nakshatra (10 credits): Nakshatra, pada and nakshatra lord of all 9 planets.
- GET /v1/chart/dignity (10 credits): Planetary dignity (exalted, debilitated, own sign, etc).
- GET /v1/chart/aspects (10 credits): Graha drishti (planetary aspects).
- GET /v1/chart/shadbala (30 credits): Six-fold strength for all planets.
- GET /v1/chart/shadbala/{component} (10 credits): Single Shadbala component (Sthana/Dig/Kala/...)
- GET /v1/chart/bhavabala (30 credits): Bhava strength for all 12 houses.
- GET /v1/chart/ashtakvarga (20 credits): Sarva + 7 Bhinna Ashtakavarga charts.
- GET /v1/chart/ashtakvarga/{planet} (10 credits): Bhinna Ashtakavarga for one planet.
- GET /v1/chart/avakhada (10 credits): Avakhada chakra (Varna/Vashya/Yoni/Gana/Nadi).
- GET /v1/chart/astro-details (30 credits): All-in-one birth chart snapshot: Avakhada + Ascendant + all planets + birth panchang (tithi/nakshatra/yoga/vara) + sun/moon sign — replaces 3 separate calls. Params: date*, time*, tz*, lat*, lon*.
- GET /v1/chart/kp-sublord (10 credits): KP system sub-lords.
- GET /v1/chart/kp-house-significator (20 credits): KP house significators — ABCD-grade significator planets for every house.
- GET /v1/chart/ghatak (10 credits): Ghatak Chakra — inauspicious tithi/vara/nakshatra/lagna combinations for the Moon sign.
- GET /v1/chart/combustion (10 credits): Combustion status for each planet.
- GET /v1/chart/graha-yuddha (10 credits): Planetary war detection.
- GET /v1/chart/house-occupants (10 credits): Which planets are in which houses.

## Dasha (14)
- GET /v1/dasha/vimshottari (20 credits): Complete 5-layer Vimshottari Dasha in one call — all 9 Maha Dashas each with 9 AD → 9 PD → 9 SD → 9 Prana sub-periods (59,049 total periods). Pass ?depth=1..5 to control nesting. Params: depth.
- GET /v1/dasha/vimshottari/current (10 credits): Current MD/AD/PD/SD/PPD period.
- GET /v1/dasha/vimshottari/{md} (10 credits): All Antar Dashas within a Maha Dasha.
- GET /v1/dasha/vimshottari/{md}/{ad} (10 credits): All Pratyantar Dashas within an Antar Dasha.
- GET /v1/dasha/vimshottari/{md}/{ad}/{pd} (10 credits): All Sookshma Dashas within a Pratyantar Dasha.
- GET /v1/dasha/vimshottari/{md}/{ad}/{pd}/{sd} (20 credits): Prana Dashas (level 5) within a Sookshma Dasha.
- GET /v1/dasha/yogini (10 credits): Yogini Dasha full schedule.
- GET /v1/dasha/yogini/current (10 credits): Current Yogini period.
- GET /v1/dasha/yogini/{name} (10 credits): Yogini dasha drill-down — antardashas inside one named Yogini period.
- GET /v1/dasha/char (10 credits): Char Dasha (Jaimini sign-based dasha) — full schedule of sign periods.
- GET /v1/dasha/char/major (10 credits): Char Dasha major periods — one row per mahadasha sign.
- GET /v1/dasha/char/current (10 credits): Currently running Char Dasha stack — active mahadasha + antardasha signs.
- GET /v1/dasha/char/{md} (10 credits): Char Dasha drill-down — antardashas inside one mahadasha sign.
- GET /v1/dasha/char/{md}/{ad} (10 credits): Char Dasha drill-down — sub-periods of a mahadasha+antardasha pair.

## Hindu Calendar (5)
- GET /v1/calendar/month (10 credits): Complete Hindu calendar for a month — all tithis, nakshatras, yogas, special days.
- GET /v1/calendar/adhik-maas (20 credits): Adhik Maas (leap month) check and next occurrence.
- GET /v1/calendar/samvatsara (10 credits): Jovian year name (Samvatsara) for a given date.
- GET /v1/calendar/ritu (10 credits): Vedic season (Ritu) for a given date.
- GET /v1/calendar/solstices (10 credits): Equinoxes and solstices of a year — exact moment, Uttarayana/Dakshinayana, and sunrise/sunset/day length at your location. Params: year*, tz, lat, lon.

## Matchmaking (Milan) (14)
- GET /v1/milan/ashtakoota (30 credits): Full 36-point Ashtakoota with the total score and all 8 kootas in one call.
- GET /v1/milan/ashtakoota/total (10 credits): Total Ashtakoota score only (quick compatibility number).
- GET /v1/milan/ashtakoota/{koota} (10 credits): Single koota score (varna/vashya/tara/yoni/graha-maitri/gana/bhakoot/nadi).
- GET /v1/milan/mangal-dosha (10 credits): Mangal Dosha with cancel rules.
- GET /v1/milan/nadi-dosha (10 credits): Nadi dosha with exceptions.
- GET /v1/milan/shani-dosha (10 credits): Shani (Saturn) dosha check.
- GET /v1/milan/navamsa-compat (20 credits): D9 navamsa compatibility.
- GET /v1/milan/dasha-sync (20 credits): Dasha synchronization score.
- GET /v1/milan/vivah-phal (10 credits): Vivah Phal — marriage outcome prediction from both charts.
- GET /v1/milan/stree-dirgha (10 credits): Stree Dirgha — distance between girl's Moon nakshatra and boy's birth star.
- GET /v1/milan/mahendra (10 credits): Mahendra koota — longevity and prosperity check.
- GET /v1/milan/longevity (10 credits): Longevity check from both charts.
- GET /v1/milan/santan-yog (10 credits): Santan Yog — progeny potential check.
- GET /v1/milan/dhan-yog (10 credits): Dhan Yog — financial prosperity compatibility.

## Muhurta (11)
- GET /v1/muhurta/vivah (30 credits): Wedding muhurta composite score.
- GET /v1/muhurta/graha-pravesh (20 credits): Housewarming muhurta.
- GET /v1/muhurta/naamkaran (20 credits): Baby-naming muhurta.
- GET /v1/muhurta/best-time (30 credits): Scan window for highest-scoring muhurta.
- GET /v1/muhurta/vyapar (20 credits): Vyapar (business) muhurta score for starting a new venture.
- GET /v1/muhurta/yatra (20 credits): Yatra (travel) muhurta — auspiciousness for journey start.
- GET /v1/muhurta/chandra-bala (10 credits): Chandra Bala — Moon strength at a given moment for muhurta.
- GET /v1/muhurta/tara-bala (10 credits): Tara Bala — natal nakshatra-to-current-nakshatra strength.
- GET /v1/muhurta/panchaka-rahita (10 credits): Panchaka Rahita check — absence of five inauspicious conditions.
- GET /v1/muhurta/shubha-yoga (10 credits): Shubha Yoga presence at a given moment.
- GET /v1/muhurta/sarvartha-siddhi (10 credits): Sarvartha Siddhi Yoga — auspicious combination of day + nakshatra.

## Transit & Gochara (8)
- GET /v1/transit/positions (10 credits): Current sidereal positions of all planets.
- GET /v1/transit/sade-sati (10 credits): Saturn 7.5-year phase for natal Moon.
- GET /v1/transit/small-panoti (10 credits): Small Panoti / Dhaiya — current status (Saturn in 4th or 8th from Moon).
- GET /v1/transit/small-panoti/history (20 credits): All Small Panoti windows for any date range.
- GET /v1/transit/tarabala (10 credits): Tarabala score for a transit.
- GET /v1/transit/vedha (10 credits): Vedha (obstruction) analysis for a transit.
- GET /v1/transit/double-transit (10 credits): Double-transit (Saturn + Jupiter) significator pairs.
- GET /v1/transit/ashtakavarga (20 credits): Birth chart Ashtakavarga overlaid with current transits.

## Eclipses (3)
- GET /v1/eclipses/solar (20 credits): Solar eclipses in a date range — type, peak, nakshatra; with lat/lon the local contact times, visibility and sutak kaal. Params: start_date*, end_date*, lat, lon, tz.
- GET /v1/eclipses/lunar (20 credits): Lunar eclipses in a date range — type, peak, nakshatra; with lat/lon the local contact times, visibility and sutak kaal. Params: start_date*, end_date*, lat, lon, tz.
- GET /v1/eclipses/all (20 credits): All solar and lunar eclipses in a date range (grahan list) — with lat/lon the local contact times, visibility and sutak kaal, as a printed panchang shows. Params: start_date*, end_date*, lat, lon, tz.

## Horoscope (3)
- GET /v1/horoscope/daily (10 credits): Daily Vedic rashi horoscope. Use ?rashi= with the Moon-sign name.
- GET /v1/horoscope/weekly (20 credits): Weekly Vedic rashi horoscope.
- GET /v1/horoscope/monthly (40 credits): Monthly Vedic rashi horoscope.

## Festivals (3)
- GET /v1/festivals/month (20 credits): Full Hindu festival calendar for a month at a location: every named Ekadashi (smarta + Vaishnava/Gauna, with parana window), Pradosh by weekday, Sankashti/Vinayaka Chaturthi, every Purnima and Amavasya (Somavati, Darsha, Anvadhan, Ishti), Chandra Darshana, all 12 Sankrantis, major + regional festivals, lunar and fixed-date jayantis, national days, eclipses. verified entry for entry against the printed panchang calendars of 14 cities. Params: year*, month*, lat, lon, tz, locale, month_system.
- GET /v1/festivals/vrat (30 credits): Year-wise Vrat & Upavas lists by type — every Ekadashi (smarta + Vaishnava, with parana), Pradosh, Sankashti, Vinayaka, Purnima, Amavasya, Chandra Darshana, Masik Shivaratri, Durgashtami, Kalashtami, Skanda Shashthi, Masik Karthigai, Shraddha (all 16 Pitru Paksha tithis), Janmashtami (Smarta/ISKCON), Sankranti, Satyanarayana Puja or eclipse of a year at a location. Params: year*, type*, lat, lon, tz, locale, month_system.
- GET /v1/festivals/on-date (10 credits): All festivals, vrats and observances on one civil date at a location — same engine and fields as /v1/festivals/month. Params: date*, lat, lon, tz, locale, month_system.

## Varshaphal (7)
- GET /v1/varshaphal/chart (30 credits): Solar-return chart for a birth year with planet positions, muntha and varsha lord in one call.
- GET /v1/varshaphal/muntha (10 credits): Muntha position for varshaphal.
- GET /v1/varshaphal/lord (10 credits): Varsha lord (year lord).
- GET /v1/varshaphal/solar-return-jd (10 credits): Exact Julian Day of solar return without computing the full chart.
- GET /v1/varshaphal/yoga (10 credits): Auspicious yogas in the solar return chart.
- GET /v1/varshaphal/harsha-bala (10 credits): Tajika Harsha Bala — five-component planetary strength in the annual chart (Stana + Uchcha + Ooja-Yugma + Kendradi + Drekkana).
- GET /v1/varshaphal/mudda-dasha (20 credits): Varshaphal Mudda Dasha — 18 annual dasha periods (9 planets × 2 cycles) starting from the Varsha lord at solar return.

## Prashna (5)
- GET /v1/prashna/chart (30 credits): Prashna (horary) chart at question moment.
- GET /v1/prashna/lagna-lord (10 credits): Prashna lagna lord.
- GET /v1/prashna/answer (30 credits): Prashna yes/no answer synthesis.
- GET /v1/prashna/arudha (10 credits): Arudha Lagna position in a prashna chart.
- GET /v1/prashna/significators (20 credits): KP significators for a prashna question.

## Numerology (9)
- GET /v1/numerology/full (20 credits): Full 5-number profile — driver, conductor, soul, personality, destiny with lucky factors.
- GET /v1/numerology/driver (10 credits): Driver number (Mulank / Birth Number) from date of birth. Master numbers 11/22/33 preserved.
- GET /v1/numerology/conductor (10 credits): Conductor number (Bhagyank / Life Path) from full DOB digit-sum.
- GET /v1/numerology/soul (10 credits): Soul / Heart's Desire number from vowels in full name.
- GET /v1/numerology/personality (10 credits): Personality number from consonants in full name.
- GET /v1/numerology/destiny (10 credits): Destiny / Expression number from all letters in full name.
- GET /v1/numerology/personal-periods (10 credits): Personal Year, Month, and Day numbers for any reference date. Lucky factors for each.
- GET /v1/numerology/challenges (10 credits): Four Challenge Numbers (CH1–CH4) from birth date — life obstacles and lessons.
- GET /v1/numerology/advanced (20 credits): Advanced profile — Maturity Number, Karmic Lessons, Sub-conscious Self, Hidden Passion, Balance Number.

## Predictions (38)
- GET /v1/vedic/narrative/lagna (10 credits): Authored narrative for the Ascendant (Lagna) sign.
- GET /v1/vedic/narrative/planets-in-signs (10 credits): Authored narratives for all planets in their natal signs.
- GET /v1/vedic/narrative/planets-in-houses (10 credits): Authored narratives for all planets in their natal houses.
- GET /v1/vedic/narrative/moon-sign (10 credits): Authored narrative for the Moon sign (Rashi).
- GET /v1/vedic/narrative/sun-sign (10 credits): Authored narrative for the Sun sign.
- GET /v1/vedic/narrative/nakshatra (10 credits): Authored narrative for the natal Moon nakshatra.
- GET /v1/vedic/narrative/house-lords-overview (10 credits): Authored narrative overview of all 12 house lords.
- GET /v1/vedic/narrative/karakas (10 credits): Authored narrative for the Chara Karakas (Atmakaraka, Amatyakaraka, etc.).
- GET /v1/vedic/narrative/yogas (20 credits): Authored narratives for all yogas present in the natal chart.
- GET /v1/vedic/narrative/doshas (20 credits): Authored narratives for all doshas present in the natal chart.
- GET /v1/vedic/narrative/divisional/{varga} (10 credits): Authored narrative for a specific divisional chart (D1–D60).
- GET /v1/vedic/narrative/planet-in-sign (10 credits): Authored narrative for a specific planet in a specific sign.
- GET /v1/vedic/narrative/planet-in-house (10 credits): Authored narrative for a specific planet in a specific house.
- GET /v1/vedic/narrative/house-lord (10 credits): Authored narrative for a specific house lord placed in a specific house.
- GET /v1/vedic/narrative/yoga/{id} (10 credits): Authored narrative for a specific yoga by ID.
- GET /v1/vedic/narrative/dosha/{id} (10 credits): Authored narrative for a specific dosha by ID.
- GET /v1/vedic/narrative/sade-sati-status (10 credits): Authored narrative for the current Sade Sati phase and its effects.
- GET /v1/vedic/narrative/profile (30 credits): Composed natal profile combining lagna + Moon sign + nakshatra + key yogas.
- GET /v1/vedic/narrative/dasha-phal (20 credits): Authored narrative for the current Vimshottari dasha period.
- GET /v1/vedic/narrative/dasha-tree-phal (20 credits): Authored narratives for the full current dasha tree (MD → AD → PD).
- GET /v1/vedic/narrative/transit-phal (20 credits): Authored narrative for current transits affecting the natal chart.
- GET /v1/vedic/narrative/transit-double (20 credits): Authored narrative for the Saturn+Jupiter double-transit significators.
- GET /v1/vedic/narrative/transit-ashtakavarga (20 credits): Authored narrative for transit strength using Ashtakavarga bindus.
- GET /v1/vedic/narrative/sade-sati-phase (10 credits): Authored narrative for the specific Sade Sati phase (rising/peak/setting).
- GET /v1/vedic/narrative/varshaphal-themes (20 credits): Authored narrative for the annual solar return (Varshaphal) themes.
- GET /v1/vedic/narrative/sade-sati-history (20 credits): Authored narrative history of all Sade Sati periods in the lifetime.
- GET /v1/vedic/narrative/yearly-bhavishyafal (30 credits): Personalized yearly horoscope from 6000+ rules: Varshaphal themes + active Dasha + Sade Sati phase + slow-mover transits + marriage/career/finance outlook — all anchored to the solar return. Params: birth.date*, birth.time*, birth.tz*, lat*, lon*, year*.
- GET /v1/vedic/narrative/horoscope/daily-by-lagna (30 credits): Daily Vedic horoscope composed from lagna + current transits.
- GET /v1/vedic/narrative/horoscope/daily-by-moon (30 credits): Daily Vedic horoscope composed from Moon sign + current transits.
- GET /v1/vedic/narrative/horoscope/daily-tamil (30 credits): Daily Vedic horoscope in Tamil tradition (panchang + rashi).
- GET /v1/vedic/narrative/horoscope/weekly-by-lagna (30 credits): Weekly Vedic horoscope by lagna.
- GET /v1/vedic/narrative/horoscope/weekly-by-moon (30 credits): Weekly Vedic horoscope by Moon sign.
- GET /v1/vedic/narrative/marriage-outlook (30 credits): Composed marriage timing and quality outlook from natal chart.
- GET /v1/vedic/narrative/career-outlook (30 credits): Composed career and professional path outlook from natal chart.
- GET /v1/vedic/narrative/finance-outlook (30 credits): Composed financial wealth outlook from natal chart.
- GET /v1/vedic/narrative/milan (30 credits): Composed compatibility narrative for a couple from both charts.
- GET /v1/vedic/narrative/reference (10 credits): Full authored reference glossary.
- GET /v1/vedic/narrative/reference/{family} (10 credits): Reference glossary for one family (e.g. yoga, dosha).

## Remedies (10)
- GET /v1/vedic/remedies (10 credits): All remedies for the natal chart — mantras, vratas, poojas for dosha/graha issues.
- GET /v1/vedic/remedies/{rule_id} (10 credits): Specific remedy by rule ID.
- GET /v1/vedic/remedies/mantra/{id} (10 credits): Mantra remedy — deity mantra + recitation count for a specific issue.
- GET /v1/vedic/remedies/vrat/{id} (10 credits): Vrat (fasting) remedy — day, procedure, deity.
- GET /v1/vedic/remedies/pooja/{id} (10 credits): Pooja remedy — ritual procedure and requirements.
- GET /v1/vedic/remedies/daan/{id} (10 credits): Daan (charity/donation) remedy — what to donate, to whom, and on which day/nakshatra.
- GET /v1/vedic/remedies/rudraksha/{id} (10 credits): Rudraksha remedy — mukhi count, ruling planet, and wearing procedure.
- GET /v1/vedic/remedies/yantra/{id} (10 credits): Yantra remedy — purpose, installation procedure, direction, and mantra.
- GET /v1/vedic/remedies/lal-kitab (10 credits): Lal Kitab remedy (upay) catalog — optionally filtered by planet.
- GET /v1/vedic/remedies/lal-kitab/{planet}/{house} (10 credits): Lal Kitab remedies for a specific planet-in-house placement (e.g. Saturn in house 8).

## Lal Kitab (3)
- GET /v1/lalkitab/chart (10 credits): Lal Kitab chart (planets mapped to Aries-based houses from Lagna).
- GET /v1/lalkitab/dasha (10 credits): 35-year Lal Kitab dasha schedule.
- GET /v1/lalkitab/dasha/current (10 credits): Currently active Lal Kitab dasha at query date.

## Ashtakavarga (4)
- GET /v1/ashtakavarga/sarva (20 credits): Sarva Ashtakavarga (SAV) — total bindus per rashi.
- GET /v1/ashtakavarga/bhinna/{planet} (20 credits): Bhinna Ashtakavarga for a single planet.
- GET /v1/ashtakavarga/kaksha (30 credits): Kaksha bindu strengths for transit planets.
- GET /v1/ashtakavarga/transit-score (20 credits): Ashtakavarga-weighted transit score.

## Planet Moments (4)
- GET /v1/planet-moments/speed (10 credits): Planet speed + retrograde state at moment.
- GET /v1/planet-moments/retrograde-window (10 credits): Next retrograde station window for a planet.
- GET /v1/planet-moments/ingress (10 credits): Next sign ingress for a planet.
- GET /v1/planet-moments/combustion-window (10 credits): Next combustion window for a planet.

## Reports (JSON / PDF) (12)
- GET /v1/reports/kundli/brihad (8000 credits): Brihad Kundli — flagship 130-page horoscope (JSON, optional PDF).
- GET /v1/reports/kundli/detailed (4000 credits): Detailed Kundli — 50+ page horoscope with house-by-house analysis, yogas, key doshas (Mangal/Kaal Sarp/Pitra), Vimshottari dasha + birth panchang.
- GET /v1/reports/kundli/lite (1500 credits): Kundli Lite — 8-page summary horoscope.
- GET /v1/reports/match-making (750 credits): Match Making — Ashtakoota + Manglik + Nadi Dosha.
- GET /v1/reports/varshaphal (750 credits): Annual prediction (Varshaphal) — solar return analysis.
- GET /v1/reports/sade-sati (750 credits): Sade Sati — 7.5-year Saturn transit deep-dive.
- GET /v1/reports/mangal-dosha (500 credits): Mangal Dosha diagnostic.
- GET /v1/reports/numerology (750 credits): 5-number Vedic numerology report.
- GET /v1/reports/dasha-analysis (750 credits): Vimshottari dasha deep-dive (5-level + 10y preview).
- GET /v1/reports/horoscope/daily (30 credits): Daily horoscope (1 rashi).
- GET /v1/reports/horoscope/weekly (60 credits): Weekly horoscope (1 rashi).
- GET /v1/reports/horoscope/monthly (120 credits): Monthly horoscope (1 rashi).

## Western Astrology (92)
- GET /v1/western/natal/planets (10 credits): All tropical planetary positions with sign, house, speed, retrograde.
- GET /v1/western/natal/planet/{name} (10 credits): Single tropical planet detail.
- GET /v1/western/natal/ascendant (10 credits): Tropical Ascendant with sign, degree, ruler.
- GET /v1/western/natal/mc (10 credits): Midheaven (MC) with sign, degree, ruler.
- GET /v1/western/natal/houses (10 credits): House cusps — Placidus, Whole Sign, Koch, Equal or 20+ other systems.
- GET /v1/western/natal/chart (30 credits): Full tropical natal chart — planets, ASC, MC, houses, aspects in one call.
- GET /v1/western/natal/aspects (20 credits): Natal aspect table with orbs, applying/separating flag, exact indicator.
- GET /v1/western/transits/positions (10 credits): Current tropical sky positions for all planets at a given moment.
- GET /v1/western/transits/to-natal (20 credits): Transit-to-natal aspects at a given moment.
- GET /v1/western/transits/exact (30 credits): Find exact moment when a transit planet aspects a natal planet.
- GET /v1/western/transits/calendar (20 credits): Day-by-day transit aspects over a date range (max 30 days, noon UTC per day).
- GET /v1/western/synastry/aspects (30 credits): Cross-chart aspects between two natal charts.
- GET /v1/western/synastry/grid (30 credits): Full synastry aspect grid (N×M matrix).
- GET /v1/western/synastry/score (30 credits): Harmony score breakdown for two charts.
- GET /v1/western/composite/planets (20 credits): Composite (midpoint) chart planets for two people.
- GET /v1/western/composite/houses (20 credits): Composite chart houses.
- GET /v1/western/composite/chart (30 credits): Full composite chart — planets, houses, aspects.
- GET /v1/western/composite/aspects (20 credits): Composite chart aspects.
- GET /v1/western/davison/planets (20 credits): Davison relationship chart planets.
- GET /v1/western/davison/houses (20 credits): Davison chart houses.
- GET /v1/western/davison/chart (30 credits): Full Davison relationship chart.
- GET /v1/western/davison/aspects (20 credits): Davison chart aspects.
- GET /v1/western/progressions/planets (20 credits): Secondary progressed planet positions.
- GET /v1/western/progressions/aspects-to-natal (20 credits): Progressed aspects to natal planets.
- GET /v1/western/progressions/lunation (20 credits): Progressed lunation phase (8-stage Moon cycle).
- GET /v1/western/solar-arc/planets (20 credits): Solar arc directed planet positions.
- GET /v1/western/solar-arc/aspects-to-natal (20 credits): Solar arc aspects to natal planets.
- GET /v1/western/returns/solar (30 credits): Solar return chart for a given year (with optional relocation).
- GET /v1/western/returns/lunar (30 credits): Lunar return chart after a given date.
- GET /v1/western/returns/solar/exact-jd (10 credits): Exact Julian Day of solar return (without computing the full chart).
- GET /v1/western/returns/solar/aspects (10 credits): Aspects formed between planets in the solar return chart.
- GET /v1/western/returns/lunar/aspects (10 credits): Aspects formed between planets in the lunar return chart.
- GET /v1/western/horoscope/daily (0 credits): Daily sun-sign horoscope by date. Perpetual via Moon transit when no static entry.
- GET /v1/western/horoscope/weekly (0 credits): Weekly sun-sign horoscope. Moon-transit based for perpetual coverage.
- GET /v1/western/horoscope/monthly (0 credits): Monthly sun-sign horoscope. June–Dec 2026 authored; yearly fallback otherwise.
- GET /v1/western/interpretation/aspect (0 credits): Authored interpretation for a natal aspect between two planets.
- GET /v1/western/interpretation/transit (0 credits): Authored interpretation for a transit-to-natal aspect.
- GET /v1/western/narrative/natal-summary (20 credits): Composed natal chart narrative — ASC, Sun, Moon, top aspects.
- GET /v1/western/narrative/transit-summary (20 credits): Composed transit narrative — most exact active transits at a moment.
- GET /v1/western/narrative/yearly (30 credits): Annual solar-return theme for a Sun sign (authored for all 12 signs).
- GET /v1/western/narrative/decan (20 credits): Authored decan (face) narrative for a zodiac degree.
- GET /v1/western/narrative/sabian (10 credits): Sabian symbol interpretation for an absolute zodiac degree (1–360).
- GET /v1/western/narrative/fixed-star/{name} (10 credits): Authored narrative for a named fixed star.
- GET /v1/western/narrative/timelord/profection (20 credits): Annual profection narrative for an activated house (1–12).
- GET /v1/western/narrative/timelord/zr (20 credits): Zodiacal Releasing narrative for a planetary lord.
- GET /v1/western/narrative/timelord/firdaria (20 credits): Firdaria time-lord narrative for a major lord.
- GET /v1/western/natal/lots (20 credits): Hellenistic Lots — Fortune, Spirit + 5 more with house placements.
- GET /v1/western/natal/lot/{name} (10 credits): Single Hellenistic Lot by name (fortune, spirit, eros, etc.).
- GET /v1/western/natal/midpoints (30 credits): Cosmobiology midpoints — all planet-pair midpoints.
- GET /v1/western/profections/annual (20 credits): Annual profection — activated sign, house, lord-of-the-year.
- GET /v1/western/profections/monthly (20 credits): Monthly profection sub-period.
- GET /v1/western/profections/daily (10 credits): Daily profection drill-down.
- GET /v1/western/zodiacal-releasing/fortune (30 credits): Zodiacal Releasing from Lot of Fortune (L1–L4 with Loosing of the Bond).
- GET /v1/western/zodiacal-releasing/spirit (30 credits): Zodiacal Releasing from Lot of Spirit.
- GET /v1/western/firdaria (20 credits): Persian Firdaria time-lords (diurnal / nocturnal scheme).
- GET /v1/western/dignities/planet (10 credits): Full essential-dignity profile for a planet at a given longitude.
- GET /v1/western/dignities/almuten (10 credits): Almuten Figuris — planet with highest dignity score at the Ascendant.
- GET /v1/western/dignities/triplicity (10 credits): Triplicity (element) ruler — day/night/active — for a zodiac degree.
- GET /v1/western/dignities/bounds (10 credits): Bound (term) ruler with full sign breakdown — Egyptian or Ptolemaic.
- GET /v1/western/dignities/face (10 credits): Face (decan) ruler using Chaldean order for a zodiac degree.
- GET /v1/western/dignities/receptions (10 credits): Mutual and mixed dignity receptions between supplied planet longitudes.
- GET /v1/western/natal/asteroid/{number} (20 credits): Any numbered asteroid position by catalog number.
- GET /v1/western/natal/asteroids/big-four-plus (20 credits): Big Four + (Ceres, Pallas, Juno, Vesta, Hygiea, Astraea, Eros, Psyche, Sappho).
- GET /v1/western/natal/centaurs (20 credits): Centaur bodies — Pholus, Nessus, Asbolus, Chariklo.
- GET /v1/western/natal/tnos (20 credits): Trans-Neptunian Objects — Eris, Sedna, Haumea, Makemake, Quaoar, Orcus, Varuna.
- GET /v1/western/natal/lilith-set (10 credits): Lilith set — Mean, True, Interpolated Black Moon + asteroid 1181.
- GET /v1/western/natal/uranian-hypotheticals (20 credits): Uranian/Hamburg school hypothetical planets (Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulkanus, Poseidon).
- GET /v1/western/natal/fixed-stars (30 credits): Fixed stars conjunct natal planets within orb — full set.
- GET /v1/western/natal/fixed-stars/{name} (10 credits): Single fixed star position and natal conjunction check.
- GET /v1/western/natal/parans (30 credits): Paran aspects — fixed stars crossing the 4 angles.
- GET /v1/western/natal/vertex-set (10 credits): Vertex, Anti-Vertex, and East Point positions.
- GET /v1/western/natal/harmonic/{n} (20 credits): Harmonic chart for any integer harmonic N.
- GET /v1/western/natal/harmonic-aspects (30 credits): Harmonic aspects across multiple harmonics simultaneously.
- GET /v1/western/natal/declinations (20 credits): Declination positions for all planets — parallel and contra-parallel aspects.
- GET /v1/western/natal/out-of-bounds (10 credits): Out-of-bounds planets (declination > 23°27′).
- GET /v1/western/natal/antiscia (20 credits): Antiscia and contra-antiscia points for all planets.
- GET /v1/western/natal/midpoint-tree (30 credits): Ebertin midpoint tree — midpoints sorted by degree with natal contacts.
- GET /v1/western/heliocentric/planets (20 credits): Heliocentric planetary positions.
- GET /v1/western/eclipses/upcoming (20 credits): Next solar and lunar eclipses with type, magnitude, path.
- GET /v1/western/eclipses/visibility (30 credits): Eclipse visibility from a specific location.
- GET /v1/western/ingresses (20 credits): Upcoming planet sign ingresses for a date range.
- GET /v1/western/retrograde-window/{planet} (20 credits): Next retrograde station window for a planet (station-retrograde → station-direct).
- GET /v1/western/astrocartography/planet-lines (30 credits): Astrocartography planet lines — Asc/Desc/MC/IC lines for all planets.
- GET /v1/western/astrocartography/local-space (20 credits): Local space chart directions from observer location.
- GET /v1/western/compatibility/sun-sign (10 credits): Sun-sign compatibility — score 0–100, element/modality analysis, strengths/challenges.
- GET /v1/western/lunar/phase (10 credits): Birth-moment Moon phase — angle, illumination %, 8 named phases, age in days.
- GET /v1/western/natal/aspect-patterns (20 credits): Detect multi-planet configurations — Grand Trine, T-Square, Grand Cross, Yod, Kite, Stellium, Grand Sextile, Mystic Rectangle.
- GET /v1/western/natal/dominant (10 credits): Chart dominance profile — element/modality distribution, most-aspected planet, Lilly dignity ranking, hemisphere balance.
- GET /v1/western/natal/chart-shape (10 credits): Jones planetary distribution pattern — Splash, Bundle, Locomotive, Bowl, Bucket, See-Saw, Splay.
- GET /v1/western/primary-directions/placidus-zodiacal (20 credits): Placidus zodiacal primary directions — all planet pairs + aspects, sorted chronologically.
- GET /v1/western/primary-directions/placidus-mundane (20 credits): Placidus mundane primary directions — promissor moved through house framework.
- GET /v1/western/primary-directions/regiomontanus (20 credits): Regiomontanus primary directions — equatorial arc method.

## Tarot (5)
- GET /v1/tarot/cards (10 credits): Full 78-card deck. Filter by ?suit=Major Arcana|Wands|Cups|Pentacles|Swords or keyword search.
- GET /v1/tarot/card/{id} (10 credits): Single card by ID (0–77). Includes upright/reversed meanings, keywords, yes/no tendency.
- GET /v1/tarot/daily (10 credits): Deterministic daily card — same card for all readers on the same date.
- GET /v1/tarot/spread (20 credits): Draw a spread: single (1 card), three (past/present/future), or celtic (10-card Celtic Cross). Seed-reproducible.
- GET /v1/tarot/yes-no (10 credits): Yes/No reading — one card with answer (yes/no/maybe) and reasoning. Seed-reproducible.

## Geo / Location (4)
- GET /v1/geo/search (0 credits): City/place search — returns lat, lon, IANA timezone. Use before any chart endpoint.
- GET /v1/geo/timezone (0 credits): Timezone lookup by lat/lon — returns IANA timezone ID + UTC offset.
- GET /v1/geo/reverse (0 credits): Reverse geocoding — nearest place name + IANA timezone for a lat/lon.
- GET /v1/geo/place/{id} (0 credits): Place details by GeoNames ID.

## Meta (7)
- GET /v1/meta/endpoints (0 credits): Full endpoint catalog.
- GET /v1/meta/ayanamsas (0 credits): Supported ayanamsa systems.
- GET /v1/meta/version (0 credits): API version + build commit.
- GET /v1/meta/vedic/yogas (0 credits): Catalog of all detectable yogas with IDs — use with /v1/vedic/narrative/yoga/{id}.
- GET /v1/meta/vedic/doshas (0 credits): Catalog of all detectable doshas with IDs — use with /v1/vedic/narrative/dosha/{id}.
- GET /v1/meta/vedic/locales (0 credits): Supported narrative locales (en + 9 Indian languages).
- GET /v1/meta/vedic/narrative-axes (0 credits): List of every narrative axis (lagna, doshas, yogas, dasha-phal, …).