{"openapi":"3.1.0","info":{"title":"Asterwise API","description":"\nB2B astrology and divination API.\nVedic (sidereal) and Western (tropical) astrology, numerology, tarot, crystals, dreams, and\nhoroscopes. Send birth data, get accurate calculations as structured JSON. 118 endpoints,\n103 MCP tools, HMAC-signed responses.\n\n**[Get your free API key](https://asterwise.com)** · [Pricing](https://asterwise.com/pages/pricing.html) · [Support](mailto:support@asterwise.com)\n\n---\n\n## Authentication\n\nAdd your API key to every request:\n```\nAuthorization: Bearer YOUR_KEY_HERE\n```\n\nGet your key at **asterwise.com** — free, no credit card, instant.\n\n---\n\n## Your first call\n```bash\ncurl https://api.asterwise.com/v1/astro/natal \\\n  -H \"Authorization: Bearer YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"Arjun Mehta\",\n    \"date\": \"1985-11-12\",\n    \"time\": \"06:45\",\n    \"location\": \"Mumbai\"\n  }'\n```\n\n---\n\n## Key concepts\n\n**`location`** — Any city name. Resolved automatically.\n\n**`ayanamsa`** — `lahiri` (default) · `raman` · `kp` · `tropical`\n\n---\n\n500 free calls/month\n\n[status.asterwise.com](https://status.asterwise.com) · [Error Reference](https://asterwise.com/pages/errors.html)\n","contact":{"name":"Asterwise","url":"https://asterwise.com/"},"license":{"name":"Commercial","identifier":"LicenseRef-Commercial"},"version":"2026-03-01"},"paths":{"/v1/astro/atmakaraka":{"post":{"tags":["Astrology"],"summary":"Jaimini Charakarakas","description":"Computes all 8 Jaimini Charakarakas from the natal chart: Atmakaraka, Amatyakaraka, Bhratrikaraka, Matrikaraka, Pitrikaraka, Putrakaraka, Gnatikaraka, and Darakaraka. The planet with the highest degree in its sign becomes the Atmakaraka. Request JSON follows BirthInput: `name` (optional, default Chart), `date` (YYYY-MM-DD), `time` (HH:MM, required), either `location` or `latitude`/`longitude`/`timezone`, optional `ayanamsa` (lahiri|raman|kp|tropical).","operationId":"get_atmakaraka_v1_astro_atmakaraka_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AtmakarakaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AtmakarakaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Chart Analysis","security":[{"BearerAuth":[]}]}},"/v1/astro/ashtakavarga":{"post":{"tags":["Advanced"],"summary":"Ashtakavarga","description":"Computes the Ashtakavarga system for a given birth chart.\n\n**What is Ashtakavarga?**\nAshtakavarga is a Vedic system that assigns benefic points (bindus) to each \nhouse based on the positions of the 7 classical planets and the Lagna (ascendant). \nIt is used to assess the relative strength of each house and to time events \nthrough transit analysis — a planet transiting a house with more bindus produces \nbetter results.\n\n**What this endpoint returns:**\n\n- **bhinna** — Bhinna Ashtakavarga (BAV): the raw contribution table for each \n  planet and the Lagna. Each entry maps Sanskrit sign name (Mesha…Meena) to bindus \n  in that sign.\n\n- **bhinna_after_trikona** — BAV after Trikona Shodana (triangular reduction). \n  Points in trinal houses are equalised. Per-planet objects keyed by sign name.\n\n- **bhinna_after_ekadhipatya** — BAV after both Trikona and Ekadhipatya Shodana \n  (lordship reduction). The most refined per-planet table, keyed by sign name.\n\n- **sarva** — Sarva Ashtakavarga (SAV): the raw sum across all 7 planets. \n  Object keyed by sign name; 28+ bindus in a sign is considered strong.\n\n- **sarva_reduced** — SAV computed from the fully reduced planet tables. \n  More accurate for transit timing. Keyed by sign name.\n\n- **after_trikona** / **after_ekadhipatya** — SAV-level reductions for \n  backward compatibility, keyed by sign name.\n\n**How to use bindus for transit timing:**\nWhen a planet transits a house in its own Bhinna chart, the number of bindus \nin that house indicates how favourable the transit will be. 8 bindus is maximum, \n0 is minimum. In the SAV, 30+ bindus in a house indicates strong positive results \nduring transits through that house.\n\n**Ayanamsa:** All positions are sidereal. Default is Lahiri.\n\nReturns Bhinna Ashtakavarga (BAV) and Sarva Ashtakavarga (SAV) scores for all planets and houses.","operationId":"ashtakavarga_v1_astro_ashtakavarga_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AshtakavargaRequest"},"examples":{"India — Arjun Mehta":{"summary":"Birth chart for Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"}},"Europe — Sofia Rossi":{"summary":"Birth chart for Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}},"Americas — James Carter":{"summary":"Birth chart for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AshtakavargaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Chart Analysis","security":[{"BearerAuth":[]}]}},"/v1/astro/ashtottari":{"post":{"tags":["Advanced"],"summary":"Ashtottari Dasha","description":"Computes Ashtottari Dasha periods for a given birth chart.\n\n**What is Ashtottari Dasha?**\nAshtottari Dasha is a 108-year dasha cycle using 8 planets (excluding Ketu). \nIt is considered applicable only for specific charts where Rahu occupies a \nKendra (houses 1, 4, 7, 10) or Trikona (houses 1, 5, 9) from the Lagna.\n\n**Applicability check:**\nThis endpoint first checks whether Ashtottari applies to the given chart.\nIf Rahu is not in a Kendra or Trikona house, the response will contain \n`applicable: false` and a reason string instead of dasha periods.\n\n**The 8 planets and their durations:**\n- Sun — 6 years\n- Moon — 15 years\n- Mars — 8 years\n- Mercury — 17 years\n- Saturn — 10 years\n- Jupiter — 19 years\n- Rahu — 12 years\n- Venus — 21 years\n\n**Levels:**\n- `levels: 1` — returns Maha Dasha periods only\n- `levels: 2` — returns Maha Dasha with Antar Dasha sub-periods (default)\n\n**Date format:** All dates are returned in DD/MM/YYYY format.\n\n**Ayanamsa:** Default is Lahiri.","operationId":"ashtottari_dasha_v1_astro_ashtottari_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AshtottariRequest"},"examples":{"Americas — James Carter":{"summary":"Ashtottari Dasha for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AshtottariEndpointResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Dashas","security":[{"BearerAuth":[]}]}},"/v1/astro/chart":{"post":{"tags":["Astrology"],"summary":"Generate Kundali chart SVG","description":"Generate Vedic astrological chart SVGs. Returns North Indian and South Indian style charts for both Lagna (D1) and Navamsa (D9), as SVG strings. Each planet shows abbreviation, degree°minutes', and superscripts for Vakri (ᴿ), Asta (ᶜ), and Vargottama (ᵛ). Returns North Indian (Uttar Bharatiya) and South Indian (Dakshina Bharatiya) Kundali charts as inline SVG. Also returns Navamsa (D9) chart. The response contains SVG strings for each chart style. To render them:\n\n1. In browser: create an HTML file,\n   paste the SVG string directly\n   into the body tag.\n\n2. In React/Vue/Angular: use\n   dangerouslySetInnerHTML or v-html\n   to render the SVG string.\n\n3. To preview instantly: copy the\n   lagna_north value and paste into\n   https://svgviewer.dev\n\nChart styles returned:\n- lagna_north: North Indian style\n  (diamond layout)\n- lagna_south: South Indian style\n  (square grid layout)\n- navamsa_north: D9 Navamsa chart\n  North Indian style\n- navamsa_south: D9 Navamsa chart\n  South Indian style\n- legend: R=Vakri(Retrograde)\n  C=Asta(Combust) V=Vargottama","operationId":"get_chart_v1_astro_chart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartRequest"},"examples":{"India — Arjun Mehta":{"summary":"Birth chart for Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"}},"Europe — Sofia Rossi":{"summary":"Birth chart for Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}},"Americas — James Carter":{"summary":"Birth chart for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"Chart SVG strings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_ChartResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Foundations","security":[{"BearerAuth":[]}]}},"/v1/astro/natal":{"post":{"tags":["Astrology"],"summary":"Natal Chart — Janam Kundali","description":"Calculate a complete Vedic natal chart using Swiss Ephemeris. Returns planet positions in sidereal zodiac, house placements (whole sign), ascendant, nakshatra data, Avakahada Chakra table, and optional classical Vedic interpretation for each planet placement. Also known as Janam Kundali or Janma Kundali. Returns planets (Grahas), houses (Bhavas), ascendant (Lagna), nakshatra positions, and avakahada table.","operationId":"get_natal_chart_v1_astro_natal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalRequest"},"examples":{"India — Arjun Mehta":{"summary":"Birth chart for Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"}},"Europe — Sofia Rossi":{"summary":"Birth chart for Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}},"Americas — James Carter":{"summary":"Birth chart for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"Natal chart with planetary and house positions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NatalResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Foundations","security":[{"BearerAuth":[]}]}},"/v1/western/natal":{"post":{"tags":["Western Astrology"],"summary":"Western Natal Chart — Tropical","description":"Calculate a complete Western natal chart using the tropical zodiac and Swiss Ephemeris. Returns 10 planet positions (Sun through Pluto) with tropical longitudes, Placidus (or chosen) house placements, essential dignities, all active aspects using standard modern Western orbs, and element/modality/hemisphere statistics. House system options: placidus (default), koch, equal, whole_sign.","operationId":"get_western_natal_chart_v1_western_natal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WesternNatalRequest"},"examples":{"Arjun Mehta — Mumbai":{"summary":"Tropical natal chart, Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","house_system":"placidus"}},"Sofia Rossi — Rome":{"summary":"Tropical natal chart, Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","house_system":"placidus"}},"James Carter — New York":{"summary":"Tropical natal chart, James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","house_system":"placidus"}}}}},"required":true},"responses":{"200":{"description":"Western natal chart with tropical positions and dignities","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_WesternNatalResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Foundations","security":[{"BearerAuth":[]}]}},"/v1/western/moon/phase":{"get":{"tags":["Western Astrology"],"summary":"Western Moon Phase","description":"Calculate the lunar phase for any date using the tropical zodiac. Returns phase name (New Moon, Waxing Crescent, First Quarter, Waxing Gibbous, Full Moon, Waning Gibbous, Last Quarter, Waning Crescent), phase angle, illumination percentage, moon age in days, and next major phase estimate. Defaults to today if no date given.","operationId":"get_moon_phase_v1_western_moon_phase_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date in YYYY-MM-DD format. Defaults to today.","examples":["2026-05-01"],"title":"Date"},"description":"Date in YYYY-MM-DD format. Defaults to today."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_MoonPhaseResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Moon and Cycles","security":[{"BearerAuth":[]}]}},"/v1/western/moon/calendar":{"get":{"tags":["Western Astrology"],"summary":"Western Moon Phase Calendar","description":"Returns lunar phase data for every day in a given month. Useful for building moon phase calendars, identifying full/new moons, and auspicious timing tools. Defaults to current month if no year/month given.","operationId":"get_moon_calendar_v1_western_moon_calendar_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Year (e.g. 2026). Defaults to current year.","title":"Year"},"description":"Year (e.g. 2026). Defaults to current year."},{"name":"month","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":12,"minimum":1},{"type":"null"}],"description":"Month number 1-12. Defaults to current month.","title":"Month"},"description":"Month number 1-12. Defaults to current month."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_MoonPhaseResponse__"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Moon and Cycles","security":[{"BearerAuth":[]}]}},"/v1/western/aspects":{"post":{"tags":["Western Astrology"],"summary":"Western Aspect Grid","description":"Calculate all active aspects between any set of planetary positions. Provide a dictionary of body names to tropical ecliptic longitudes. Uses standard modern Western orbs by default: major aspects 5°, sextile 3°, minor aspects 1.5°. Custom orbs can be provided per aspect type.","operationId":"get_western_aspects_v1_western_aspects_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WesternAspectsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_WesternAspectsResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Foundations","security":[{"BearerAuth":[]}]}},"/v1/western/transits/daily":{"post":{"tags":["Western Astrology"],"summary":"Western Daily Transits","description":"Current sky positions vs natal chart. Returns all 10 planets with tropical longitudes and active aspects to natal positions using standard modern Western transit orbs: major 3°, sextile 2°, minor 1°. Defaults to today if no date given.","operationId":"get_daily_transits_v1_western_transits_daily_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WesternTransitRequest"},"examples":{"Arjun Mehta — daily transits":{"summary":"Daily transits for Arjun Mehta","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai"}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DailyTransitResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Transits","security":[{"BearerAuth":[]}]}},"/v1/western/transits/weekly":{"post":{"tags":["Western Astrology"],"summary":"Western Weekly Transits","description":"7-day transit window vs natal chart. Returns day-by-day transit snapshots plus peak aspects (active 4+ days in the window). Use start_date to set the week start. Defaults to today.","operationId":"get_weekly_transits_v1_western_transits_weekly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WesternTransitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_WeeklyTransitResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Transits","security":[{"BearerAuth":[]}]}},"/v1/western/transits/monthly":{"post":{"tags":["Western Astrology"],"summary":"Western Monthly Transits","description":"30-day transit window vs natal chart. Returns day-by-day transit snapshots plus peak aspects (active 10+ days in the window). Use start_date to set the month start. Defaults to today.","operationId":"get_monthly_transits_v1_western_transits_monthly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WesternTransitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_MonthlyTransitResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Transits","security":[{"BearerAuth":[]}]}},"/v1/western/synastry":{"post":{"tags":["Western Astrology"],"summary":"Western Synastry","description":"Aspect grid between two natal charts using the tropical zodiac. Returns all inter-chart aspects using standard modern Western orbs. Useful for relationship compatibility analysis.","operationId":"get_synastry_v1_western_synastry_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoPersonRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_SynastryResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Synastry and Compatibility","security":[{"BearerAuth":[]}]}},"/v1/western/composite":{"post":{"tags":["Western Astrology"],"summary":"Western Composite Chart","description":"Midpoint composite chart for two people using modern Western midpoint technique. Each composite planet is the midpoint of the two natal positions. Returns composite planets with dignities and internal aspects.","operationId":"get_composite_v1_western_composite_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoPersonRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_CompositeResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Synastry and Compatibility","security":[{"BearerAuth":[]}]}},"/v1/western/compatibility":{"post":{"tags":["Western Astrology"],"summary":"Western Compatibility Score","description":"Overall compatibility score (0-100) between two natal charts. Scores element affinity, synastry aspects between personal planets (Sun, Moon, Venus, Mars), and Sun/Moon/rising sign comparisons.","operationId":"get_compatibility_v1_western_compatibility_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoPersonRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__response__ApiResponse_CompatibilityResponse___1"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Synastry and Compatibility","security":[{"BearerAuth":[]}]}},"/v1/western/compatibility/zodiac":{"get":{"tags":["Western Astrology"],"summary":"Western Zodiac Sign Compatibility","description":"Sign-to-sign compatibility without birth data. Based on element and modality affinity. Pass sign names as query parameters: ?sign1=Aries&sign2=Leo","operationId":"get_zodiac_compatibility_v1_western_compatibility_zodiac_get","parameters":[{"name":"sign1","in":"query","required":true,"schema":{"type":"string","title":"Sign1"}},{"name":"sign2","in":"query","required":true,"schema":{"type":"string","title":"Sign2"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_ZodiacCompatibilityResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Synastry and Compatibility","security":[{"BearerAuth":[]}]}},"/v1/western/solar-return":{"post":{"tags":["Western Astrology"],"summary":"Western Solar Return","description":"Solar return chart for a given year. Finds the exact moment the Sun returns to its natal tropical longitude and builds a complete Western natal chart for that moment at the birth location. Provide the year as an integer (e.g. 2026).","operationId":"get_solar_return_v1_western_solar_return_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolarReturnRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_ReturnChartResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Returns","security":[{"BearerAuth":[]}]}},"/v1/western/lunar-return":{"post":{"tags":["Western Astrology"],"summary":"Western Lunar Return","description":"Next lunar return chart after a given date. Finds the next moment the Moon returns to its natal tropical longitude (~every 27.3 days) and builds a complete Western natal chart for that moment at the birth location.","operationId":"get_lunar_return_v1_western_lunar_return_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LunarReturnRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_ReturnChartResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Returns","security":[{"BearerAuth":[]}]}},"/v1/western/planetary-return":{"post":{"tags":["Western Astrology"],"summary":"Western Planetary Return","description":"Next return chart for any planet after a given date. Finds the exact moment the specified planet returns to its natal tropical longitude and builds a complete Western natal chart for that moment at the birth location. Supported planets: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto.","operationId":"get_planetary_return_v1_western_planetary_return_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanetaryReturnRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_ReturnChartResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Returns","security":[{"BearerAuth":[]}]}},"/v1/western/progressions/secondary":{"post":{"tags":["Western Astrology"],"summary":"Western Secondary Progressions","description":"Secondary progressed chart using the day-for-a-year method. Each day after birth symbolises one year of life (1 ephemeris day = 1 tropical year = 365.2421904 days). Returns all 10 progressed planet positions, progressed Ascendant and MC (Solar Arc MC method), and the solar arc. Defaults to today if no target_date provided.","operationId":"get_secondary_progressions_v1_western_progressions_secondary_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_SecondaryProgressionResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Progressions and Directions","security":[{"BearerAuth":[]}]}},"/v1/western/progressions/solar-arc":{"post":{"tags":["Western Astrology"],"summary":"Western Solar Arc Directions","description":"Solar Arc Directions for a target date. The solar arc (progressed Sun - natal Sun) is applied uniformly to every natal planet and angle. Unlike secondary progressions, all planets advance at the same rate (~1° per year). Returns directed positions for all 10 planets plus directed MC and ASC.","operationId":"get_solar_arc_v1_western_progressions_solar_arc_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_SolarArcResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Progressions and Directions","security":[{"BearerAuth":[]}]}},"/v1/astro/panchanga":{"post":{"tags":["Astrology"],"summary":"Daily Panchanga","description":"Calculate Vedic Panchanga for a given date and location. Returns Tithi, Nakshatra, Yoga, Karana, Vara (weekday), and auspicious and inauspicious periods for the day. Returns Tithi, Vara (weekday), Nakshatra, Yoga, and Karana for the birth date and location.","operationId":"panchanga_v1_astro_panchanga_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangaRequest"},"examples":{"India — Arjun Mehta":{"summary":"Birth chart for Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"}},"Europe — Sofia Rossi":{"summary":"Birth chart for Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}},"Americas — James Carter":{"summary":"Birth chart for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PanchangaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Panchanga and Calendar","security":[{"BearerAuth":[]}]}},"/v1/astro/panchanga/choghadiya":{"post":{"tags":["Astrology"],"summary":"Choghadiya periods","description":"Calculate all 16 Choghadiya periods (8 day + 8 night) for a given date and location. Each period is classified (e.g. highly auspicious for Amrit, good, beneficial, neutral, or inauspicious) with the ruling planet.","operationId":"get_choghadiya_v1_astro_panchanga_choghadiya_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangaExtRequest"},"examples":{"Mumbai":{"summary":"Mumbai, India","value":{"date":"2026-03-23","location":"Mumbai"}},"New York (with coordinates)":{"summary":"New York with lat/lon/tz","value":{"date":"2026-03-23","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}}}}},"required":true},"responses":{"200":{"description":"Day and night Choghadiya periods with start/end times and classification","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_ChoghadiyaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Panchanga and Calendar","security":[{"BearerAuth":[]}]}},"/v1/astro/panchanga/hora":{"post":{"tags":["Astrology"],"summary":"Planetary hours (Hora)","description":"Calculate all 24 Hora (planetary hours) for a given date and location using unequal seasonal division: 12 equal parts from sunrise to sunset and 12 from sunset to next sunrise. The first hora after sunrise is ruled by the sunrise-boundary Vedic vara lord; subsequent horas follow the Chaldean sequence. Response includes a convention field naming the division used.","operationId":"get_hora_v1_astro_panchanga_hora_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangaExtRequest"},"examples":{"Mumbai":{"summary":"Mumbai, India","value":{"date":"2026-03-23","location":"Mumbai"}},"New York (with coordinates)":{"summary":"New York with lat/lon/tz","value":{"date":"2026-03-23","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}}}}},"required":true},"responses":{"200":{"description":"24 planetary hours with ruling planet, start/end times, convention, and suitable activities","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_HoraResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Panchanga and Calendar","security":[{"BearerAuth":[]}]}},"/v1/astro/panchanga/rahu-kaal":{"post":{"tags":["Astrology"],"summary":"Rahu Kaal, Gulika Kaal, Yamaganda Kaal","description":"Calculate the three inauspicious time periods for a given date and location. Rahu Kaal, Gulika Kaal (Mandi), and Yamaganda Kaal are avoided for starting auspicious activities. All three are based on dividing the day into 8 equal parts from sunrise to sunset.","operationId":"get_rahu_kaal_v1_astro_panchanga_rahu_kaal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangaExtRequest"},"examples":{"Mumbai":{"summary":"Mumbai, India","value":{"date":"2026-03-23","location":"Mumbai"}},"New York (with coordinates)":{"summary":"New York with lat/lon/tz","value":{"date":"2026-03-23","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}}}}},"required":true},"responses":{"200":{"description":"Start and end times for Rahu Kaal, Gulika Kaal, and Yamaganda Kaal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_RahuKaalResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Panchanga and Calendar","security":[{"BearerAuth":[]}]}},"/v1/astro/panchanga/calendar":{"get":{"tags":["Astrology"],"summary":"Monthly Panchanga calendar","description":"Calculate complete Panchanga for every day of a given month at a given location. Returns all 5 Panchanga elements (Tithi, Vara, Nakshatra, Yoga, Karana) plus Rahu Kaal for each day. Useful for building monthly almanac views.","operationId":"get_panchanga_calendar_v1_astro_panchanga_calendar_get","parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":1900,"description":"Year","examples":[2026],"title":"Year"},"description":"Year"},{"name":"month","in":"query","required":true,"schema":{"type":"integer","maximum":12,"minimum":1,"description":"Month (1-12)","examples":[3],"title":"Month"},"description":"Month (1-12)"},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"City name","examples":["Mumbai"],"title":"Location"},"description":"City name"},{"name":"latitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"title":"Latitude"}},{"name":"longitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"title":"Longitude"}},{"name":"timezone","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"IANA timezone (required with lat/lon; ignored when using location alone)","examples":["Asia/Kolkata"],"default":"Asia/Kolkata","title":"Timezone"},"description":"IANA timezone (required with lat/lon; ignored when using location alone)"},{"name":"ayanamsa","in":"query","required":false,"schema":{"enum":["lahiri","raman","kp","tropical"],"type":"string","default":"lahiri","title":"Ayanamsa"}}],"responses":{"200":{"description":"All Panchanga elements for every day of the month","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PanchangaCalendarResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Panchanga and Calendar","security":[{"BearerAuth":[]}]},"post":{"tags":["Astrology"],"summary":"Monthly Panchanga calendar (JSON body)","description":"Same data as GET /v1/astro/panchanga/calendar. Minimum required JSON fields: `year` (1900–2100), `month` (1–12), `lat`, `lon`. Optional `timezone` defaults to Asia/Kolkata.","operationId":"post_panchanga_calendar_v1_astro_panchanga_calendar_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangaCalendarPostBody"}}}},"responses":{"200":{"description":"All Panchanga elements for every day of the month","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PanchangaCalendarResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Panchanga and Calendar","security":[{"BearerAuth":[]}]}},"/v1/astro/panchanga/tamil":{"get":{"tags":["Astrology"],"summary":"Tamil Panchanga","description":"Tamil-specific Panchanga for a date and location. Returns all four Tamil inauspicious periods (Rahu Kalam, Yamagandam, Kuligai, Emagandam), Nalla Neram (auspicious daytime windows between inauspicious periods), and the Tamil solar month name derived from the Sun's sidereal position at sunrise.","operationId":"get_tamil_panchanga_v1_astro_panchanga_tamil_get","parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string","description":"Date in YYYY-MM-DD format","examples":["2026-05-03"],"title":"Date"},"description":"Date in YYYY-MM-DD format"},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"City name","examples":["Chennai"],"title":"Location"},"description":"City name"},{"name":"latitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"title":"Latitude"}},{"name":"longitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"title":"Longitude"}},{"name":"timezone","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"IANA timezone","default":"Asia/Kolkata","title":"Timezone"},"description":"IANA timezone"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_TamilPanchangaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Panchanga and Calendar","security":[{"BearerAuth":[]}]}},"/v1/astro/panchanga/festivals":{"get":{"tags":["Astrology"],"summary":"Hindu festival calendar","description":"Compute all major Hindu festival dates for a given year and location. Returns 20 pan-Hindu festivals including solar sankrantis (Makar Sankranti, Vaisakhi) and tithi-based festivals (Diwali, Holi, Dussehra, Janmashtami, Ganesh Chaturthi, Ram Navami, and 12 others). All dates are astronomically computed — no hardcoded dates. Tithi festivals use the Sun-Moon elongation at local sunrise with Lahiri sidereal ayanamsa. Location is required for accurate sunrise-based tithi determination.","operationId":"get_festival_calendar_v1_astro_panchanga_festivals_get","parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":1900,"description":"Calendar year","examples":[2026],"title":"Year"},"description":"Calendar year"},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"City name","examples":["Mumbai"],"title":"Location"},"description":"City name"},{"name":"latitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"title":"Latitude"}},{"name":"longitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"title":"Longitude"}},{"name":"timezone","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"IANA timezone","default":"Asia/Kolkata","title":"Timezone"},"description":"IANA timezone"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_FestivalCalendarResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Panchanga and Calendar","security":[{"BearerAuth":[]}]}},"/v1/astro/divisional":{"post":{"tags":["Advanced"],"summary":"Divisional charts — Varga","description":"Computes all 16 Vedic divisional charts (Varga charts) for a given\nbirth date, time, and location.\n\n**What are divisional charts?**\nIn Vedic astrology, the birth chart (D1) is divided into progressively finer\nsubdivisions to reveal different areas of life. Each divisional chart isolates\na specific domain — the D9 Navamsha reveals spouse and dharma, the D10 Dashamsha\nreveals career, the D60 Shashtyamsha is the most subtle and reveals karmic residue\nfrom past lives.\n\n**The 16 charts returned:**\n- D1 — Rashi (natal chart)\n- D2 — Hora (wealth)\n- D3 — Drekkana (siblings)\n- D4 — Chaturthamsha (property)\n- D7 — Saptamsha (children)\n- D9 — Navamsha (spouse, dharma) — the most consulted divisional chart\n- D10 — Dashamsha (career)\n- D12 — Dwadashamsha (parents)\n- D16 — Shodashamsha (vehicles)\n- D20 — Vimshamsha (spirituality)\n- D24 — Chaturvimshamsha (education)\n- D27 — Bhamsha (vitality)\n- D30 — Trimshamsha (misfortunes)\n- D40 — Khavedamsha (auspicious effects)\n- D45 — Akshavedamsha (all life matters)\n- D60 — Shashtyamsha (subtle karmic residue)\n\nEach chart shows every planet's sign placement within that divisional\nsubdivision. Use the D9 alongside the D1 for most interpretive work.\n\n**Ayanamsa:** All positions are sidereal. Default is Lahiri.\n\nAlso known as Varga charts or Amsha charts. Only the requested chart_type is returned. To get all sixteen charts, omit the chart_type parameter.","operationId":"divisional_charts_v1_astro_divisional_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DivisionalRequest"},"examples":{"India — Arjun Mehta":{"summary":"Birth chart for Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"}},"Europe — Sofia Rossi":{"summary":"Birth chart for Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}},"Americas — James Carter":{"summary":"Birth chart for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DivisionalResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Chart Analysis","security":[{"BearerAuth":[]}]}},"/v1/horoscope/daily/{moon_sign}":{"get":{"tags":["Horoscope"],"summary":"Daily horoscope","description":"Returns today's pre-generated daily horoscope for the given Moon sign. Content is computed from Vedic transit data and generated using AI. Returns 404 if today's horoscope has not been generated yet.","operationId":"get_daily_horoscope_v1_horoscope_daily__moon_sign__get","parameters":[{"name":"moon_sign","in":"path","required":true,"schema":{"type":"string","title":"Moon Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_HoroscopeData_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/horoscope/weekly/{moon_sign}":{"get":{"tags":["Horoscope"],"summary":"Weekly horoscope","description":"Returns this week's pre-generated weekly horoscope for the given Moon sign.","operationId":"get_weekly_horoscope_v1_horoscope_weekly__moon_sign__get","parameters":[{"name":"moon_sign","in":"path","required":true,"schema":{"type":"string","title":"Moon Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_HoroscopeData_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/horoscope/monthly/{moon_sign}":{"get":{"tags":["Horoscope"],"summary":"Monthly horoscope","description":"Returns this month's pre-generated monthly horoscope for the given Moon sign.","operationId":"get_monthly_horoscope_v1_horoscope_monthly__moon_sign__get","parameters":[{"name":"moon_sign","in":"path","required":true,"schema":{"type":"string","title":"Moon Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_HoroscopeData_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/horoscope/yearly/{moon_sign}":{"get":{"tags":["Horoscope"],"summary":"Yearly horoscope","description":"Returns this year's pre-generated yearly horoscope for the given Moon sign.","operationId":"get_yearly_horoscope_v1_horoscope_yearly__moon_sign__get","parameters":[{"name":"moon_sign","in":"path","required":true,"schema":{"type":"string","title":"Moon Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_HoroscopeData_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/western/horoscope/daily/{sun_sign}":{"get":{"tags":["Western"],"summary":"Western daily horoscope","description":"Returns today's pre-generated Western daily horoscope for the given Sun sign (tropical).","operationId":"get_daily_western_horoscope_v1_western_horoscope_daily__sun_sign__get","parameters":[{"name":"sun_sign","in":"path","required":true,"schema":{"type":"string","title":"Sun Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_WesternHoroscopeData_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/western/horoscope/weekly/{sun_sign}":{"get":{"tags":["Western"],"summary":"Western weekly horoscope","description":"Returns this week's pre-generated Western weekly horoscope for the given Sun sign.","operationId":"get_weekly_western_horoscope_v1_western_horoscope_weekly__sun_sign__get","parameters":[{"name":"sun_sign","in":"path","required":true,"schema":{"type":"string","title":"Sun Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_WesternHoroscopeData_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/western/horoscope/monthly/{sun_sign}":{"get":{"tags":["Western"],"summary":"Western monthly horoscope","description":"Returns this month's pre-generated Western monthly horoscope for the given Sun sign.","operationId":"get_monthly_western_horoscope_v1_western_horoscope_monthly__sun_sign__get","parameters":[{"name":"sun_sign","in":"path","required":true,"schema":{"type":"string","title":"Sun Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_WesternHoroscopeData_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/western/horoscope/yearly/{sun_sign}":{"get":{"tags":["Western"],"summary":"Western yearly horoscope","description":"Returns this year's pre-generated Western yearly horoscope for the given Sun sign.","operationId":"get_yearly_western_horoscope_v1_western_horoscope_yearly__sun_sign__get","parameters":[{"name":"sun_sign","in":"path","required":true,"schema":{"type":"string","title":"Sun Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_WesternHoroscopeData_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/astro/muhurta":{"post":{"tags":["Astrology"],"summary":"Muhurta — Auspicious Timing","description":"Finds and ranks auspicious time windows for a specific event type. Scores each Choghadiya period using Choghadiya quality, Yoga, Vara (weekday), and Tithi. Returns top N ranked windows. Supported events: marriage, travel, business, griha_pravesh, naming_ceremony.","operationId":"get_muhurta_v1_astro_muhurta_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MuhurtaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_MuhurtaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Forecasting","security":[{"BearerAuth":[]}]}},"/v1/astro/dasha":{"post":{"tags":["Astrology"],"summary":"Vimshottari Dasha","description":"Calculate the complete Vimshottari Dasha timeline for a birth chart. Returns Mahadasha, Antardasha, Pratyantar, Sookshma, and Prana periods up to 5 levels deep, with start and end dates for each. The starting planet is determined by the Moon's nakshatra at birth (Janma Nakshatra). Interpretation text accompanies the currently active Mahadasha and Antardasha.","operationId":"get_dasha_periods_v1_astro_dasha_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashaRequest"},"examples":{"India — Arjun Mehta":{"summary":"Birth chart for Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"}},"Europe — Sofia Rossi":{"summary":"Birth chart for Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}},"Americas — James Carter":{"summary":"Birth chart for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}},"Standard — 2 levels":{"summary":"Mahadasha + Antardasha (recommended default)","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri","levels":2}},"Deep — 5 levels":{"summary":"All 5 dasha levels (Mahadasha → Prana)","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri","levels":5}}}}},"required":true},"responses":{"200":{"description":"Vimshottari dasha periods with start and end ranges","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DashaEndpointResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Dashas","security":[{"BearerAuth":[]}]}},"/v1/astro/dasha-transits":{"post":{"tags":["Astrology"],"summary":"Dasha-Transit Correlation","description":"Correlates active Vimshottari Dasha lords (maha, antar, pratyantar) with current planetary transits. Returns conjunction and aspect correlations scored by strength, and highlights periods of significance. Request JSON follows BirthInput plus optional `target_date`, `target_time`, `target_timezone` for the analysis moment: `name`, `date`, `time`, `location` or `latitude`/`longitude`/`timezone`, `ayanamsa`.","operationId":"get_dasha_transits_v1_astro_dasha_transits_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashaTransitsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DashaTransitsResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Dashas","security":[{"BearerAuth":[]}]}},"/v1/astro/char-dasha":{"post":{"tags":["Astrology"],"summary":"Jaimini Char Dasha","description":"Computes Jaimini Char Dasha — a sign-based dasha system from the Jaimini school of astrology. Returns mahadasha and antardasha periods starting from the ascendant (Lagna), with the current active mahadasha and antardasha highlighted. Request JSON follows BirthInput plus `cycles` (1–3): `name`, `date` (YYYY-MM-DD), `time` (HH:MM, required), either `location` or `latitude`/`longitude`/`timezone`, `ayanamsa`.","operationId":"get_char_dasha_v1_astro_char_dasha_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CharDashaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_CharDashaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Dashas","security":[{"BearerAuth":[]}]}},"/v1/astro/matchmaking/dashakoot":{"post":{"tags":["Astrology"],"summary":"Dashakoot — 10-Koota Compatibility","description":"Computes all 10 kootas for two persons: the standard 8 Ashtakoot kootas plus Mahendra and Stree Deergha. Returns total score out of 38, per-koota breakdown, dosha analysis (Nadi, Bhakoot, Rajju, Vedha), and compatibility level.","operationId":"get_dashakoot_v1_astro_matchmaking_dashakoot_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashakootRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DashakootResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Matchmaking","security":[{"BearerAuth":[]}]}},"/v1/astro/matchmaking/papasamyam":{"post":{"tags":["Astrology"],"summary":"Papasamyam — Malefic Planet Compatibility","description":"Computes Papasamyam between two natal charts. Scores each person based on Sun, Mars, Saturn, Rahu, Ketu in houses 1, 2, 4, 7, 8, 12 from Lagna, Moon, and Venus (#105). Compatible if score difference ≤ 11. person1 = groom, person2 = bride.","operationId":"get_papasamyam_v1_astro_matchmaking_papasamyam_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PapasamyamRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PapasamyamResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Matchmaking","security":[{"BearerAuth":[]}]}},"/v1/astro/matchmaking/porutham":{"post":{"tags":["Astrology"],"summary":"Kerala Porutham — 10-Porutham Compatibility","description":"Computes all 10 Kerala Poruthams: Dinam, Ganam, Mahendra, Stree Deergha, Yoni, Rasi, Rasiyathipaty, Rajju, Vedha, and Vasya. Rajju and Vedha are absolute vetoes — if either fails the match is prohibited. person1 = groom, person2 = bride.","operationId":"get_porutham_v1_astro_matchmaking_porutham_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortuthamRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PoruthamResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Matchmaking","security":[{"BearerAuth":[]}]}},"/v1/astro/matchmaking/thirumana-porutham":{"post":{"tags":["Astrology"],"summary":"Tamil Thirumana Porutham — 10-Porutham Compatibility","description":"Computes all 10 Tamil Thirumana Poruthams with Tamil naming convention. Includes Rajju severity classification (Siro=most severe to Pada=least severe). Rajju and Vedha are absolute vetoes. person1 = groom, person2 = bride.","operationId":"get_thirumana_porutham_v1_astro_matchmaking_thirumana_porutham_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThirumanaPoruthamRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_ThirumanaPoruthamResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Matchmaking","security":[{"BearerAuth":[]}]}},"/v1/astro/dosha":{"post":{"tags":["Astrology"],"summary":"Calculate dosha report","description":"Detect all major Vedic doshas in a natal chart — Mangal Dosha, Kaal Sarp Dosha, Gandmool, Grahan, Guru Chandal, Kemdrum, Shrapit, and Pitru Dosha. Present doshas include cancellation analysis, classical interpretation, keywords, and traditional remedies.","operationId":"get_dosha_report_v1_astro_dosha_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaRequest"},"examples":{"India — Arjun Mehta":{"summary":"Birth chart for Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"}},"Europe — Sofia Rossi":{"summary":"Birth chart for Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}},"Americas — James Carter":{"summary":"Birth chart for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"Detected doshas with flags, types, and details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DoshaEndpointResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Yogas and Doshas","security":[{"BearerAuth":[]}]}},"/v1/astro/gochar":{"post":{"tags":["Astrology"],"summary":"Gochar — Transit Analysis","description":"Computes planetary transits against a natal chart using classical Vedic rules. Returns house positions from Moon and Lagna, Vedha obstruction checks, Ashtakavarga Bhinna scores, Sade Sati and Chandra Ashtama flags, and classical transit interpretations for all 9 planets. Request JSON follows BirthInput plus optional transit fields `target_date`, `target_time`, `target_timezone`: `name`, `date`, `time`, `location` or `latitude`/`longitude`/`timezone`, `ayanamsa`.","operationId":"get_gochar_v1_astro_gochar_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GocharRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_GocharResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Forecasting","security":[{"BearerAuth":[]}]}},"/v1/astro/yoga":{"post":{"tags":["Astrology"],"summary":"Calculate yoga combinations","description":"Detect all classical Vedic yogas in a natal chart — Pancha Mahapurusha Yogas, Raja Yogas, Gajakesari, Neecha Bhanga Raja Yoga, Budhaditya, Chandra Mangala, and more. Each detected yoga returns formation conditions, classical results, modern summary, and keywords.","operationId":"get_yoga_report_v1_astro_yoga_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YogaRequest"},"examples":{"India — Arjun Mehta":{"summary":"Birth chart for Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"}},"Europe — Sofia Rossi":{"summary":"Birth chart for Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}},"Americas — James Carter":{"summary":"Birth chart for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"List of detected yoga combinations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_YogaEndpointResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Yogas and Doshas","security":[{"BearerAuth":[]}]}},"/v1/astro/matchmaking":{"post":{"tags":["Astrology"],"summary":"Kundali Milan — Matchmaking","description":"Complete Vedic compatibility analysis using Ashtakoot Guna Milan (36-point system). Returns all 8 koota scores, Mangal Dosha compatibility with Dosha Samya analysis, classical veto checks (Vedha and Rajju Dosha), supplementary checks (Mahendra, Stree Deergha), and compatibility narrative with strengths, concerns, and recommendation. Also known as Kundali Milan, Gun Milan, or Ashtakoot Milan. Calculates 36-point compatibility score with Rajju, Vedha, and Dosha Samya classical rules.","operationId":"get_matchmaking_report_v1_astro_matchmaking_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchmakingRequest"},"examples":{"Cross-cultural match":{"summary":"Kundali Milan — Arjun (India) + Sofia (Italy)","value":{"person1":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"},"person2":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}}}}}},"required":true},"responses":{"200":{"description":"Matchmaking compatibility score and dosha analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_MatchmakingResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Matchmaking","security":[{"BearerAuth":[]}]}},"/v1/numerology/profile":{"post":{"tags":["Numerology"],"summary":"Generate numerology profile","description":"Builds a complete numerology profile from name and birth date (BirthInput-aligned: `name`, `date`). Requires authenticated API key access (Core tier or above in product terms). Returns core numbers, interpretations, cycles, and supportive metadata.","operationId":"get_numerology_profile_v1_numerology_profile_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumerologyRequest"},"examples":{"India":{"summary":"Arjun Mehta","value":{"name":"Arjun Mehta","date":"1985-11-12"}},"Americas":{"summary":"James Carter","value":{"name":"James Carter","date":"1983-03-08"}}}}},"required":true},"responses":{"200":{"description":"Full numerology profile with core number interpretations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NumerologyProfileResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Core Numbers","security":[{"BearerAuth":[]}]}},"/v1/numerology/compatibility":{"post":{"tags":["Numerology"],"summary":"Calculate numerology compatibility","description":"Computes compatibility between two people from their numerology signatures. Each person uses `name` and `date` (BirthInput-aligned). Requires authenticated API key access (Core tier or above in product terms). Returns score, level, and explanatory strengths/challenges.","operationId":"get_numerology_compatibility_v1_numerology_compatibility_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatibilityRequest"},"examples":{"Cross-cultural":{"summary":"Arjun Mehta + Sofia Rossi","value":{"person1":{"name":"Arjun Mehta","date":"1985-11-12"},"person2":{"name":"Sofia Rossi","date":"1990-06-21"}}}}}},"required":true},"responses":{"200":{"description":"Numerology compatibility score and interpretation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__response__ApiResponse_CompatibilityResponse___2"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Compatibility and Lucky","security":[{"BearerAuth":[]}]}},"/v1/numerology/life-path":{"get":{"tags":["Numerology"],"summary":"Get life path number","description":"Calculates the life path number for a birth date and returns interpretation details. Query: `date` (YYYY-MM-DD). Requires authenticated API key access (Core tier or above in product terms). Returns number, master/karmic markers, and guidance keywords.","operationId":"get_life_path_number_v1_numerology_life_path_get","parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Birth date (YYYY-MM-DD)","title":"Date"},"description":"Birth date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Life path number with interpretation metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_LifePathResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Core Numbers","security":[{"BearerAuth":[]}]}},"/v1/numerology/personal-year":{"get":{"tags":["Numerology"],"summary":"Get personal year number","description":"Calculates personal year influence for a given birth date and target year. Query: `date`, `year`. Requires authenticated API key access (Core tier or above in product terms). Returns theme, opportunities, challenges, and practical advice.","operationId":"get_personal_year_number_v1_numerology_personal_year_get","parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Birth date (YYYY-MM-DD)","title":"Date"},"description":"Birth date (YYYY-MM-DD)"},{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":1900,"title":"Year"}}],"responses":{"200":{"description":"Personal year number and yearly guidance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PersonalYearResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Cycles and Timing","security":[{"BearerAuth":[]}]},"post":{"tags":["Numerology"],"summary":"Get personal year number (JSON body)","description":"Same calculation as GET /v1/numerology/personal-year with an MCP-friendly JSON body: `name`, `date` (YYYY-MM-DD), optional `year` (defaults to the current calendar year).","operationId":"post_personal_year_number_v1_numerology_personal_year_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalYearPostRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PersonalYearResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Cycles and Timing","security":[{"BearerAuth":[]}]}},"/v1/numerology/business-name":{"get":{"tags":["Numerology"],"summary":"Business Name Numerology","description":"Scores a business name using Pythagorean expression number. Returns single digit, theme, harmony score (1-10), and recommended uses.","operationId":"get_business_name_v1_numerology_business_name_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"description":"Business name","title":"Name"},"description":"Business name"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_BusinessNameAnalysisResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Practical Numerology","security":[{"BearerAuth":[]}]},"post":{"tags":["Numerology"],"summary":"Business Name Numerology (JSON body)","description":"Same analysis as GET /v1/numerology/business-name for clients that send a JSON body (e.g. MCP): `{ \"name\": \"...\" }`.","operationId":"post_business_name_v1_numerology_business_name_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessNamePostRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_BusinessNameAnalysisResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Practical Numerology","security":[{"BearerAuth":[]}]}},"/v1/numerology/lucky-numbers":{"get":{"tags":["Numerology"],"summary":"Generate lucky numbers","description":"Generates a deterministic lucky number set from `name` and `date` query params (BirthInput-aligned). Requires authenticated API key access (Core tier or above in product terms). Returns lucky numbers with supporting numerology context.","operationId":"get_lucky_numbers_v1_numerology_lucky_numbers_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"title":"Name"}},{"name":"date","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Birth date (YYYY-MM-DD)","title":"Date"},"description":"Birth date (YYYY-MM-DD)"},{"name":"count","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":6,"title":"Count"}}],"responses":{"200":{"description":"Lucky number list for the requested profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_LuckyNumbersApiResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Compatibility and Lucky","security":[{"BearerAuth":[]}]}},"/v1/numerology/meaning/{number}":{"get":{"tags":["Numerology"],"summary":"Get number meaning by context","description":"Returns interpretation details for a specific number within a numerology context. Query `context` defaults to `general` (same meanings as life path). Requires authenticated API key access (Core tier or above in product terms). Returns meaning text and optional thematic guidance fields.","operationId":"get_number_meaning_v1_numerology_meaning__number__get","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"integer","title":"Number"}},{"name":"context","in":"query","required":false,"schema":{"enum":["general","life_path","expression","soul_urge","personality","birth_day","personal_year"],"type":"string","description":"Interpretation family. `general` defaults to life_path meanings; other values select that specific table.","default":"general","title":"Context"},"description":"Interpretation family. `general` defaults to life_path meanings; other values select that specific table."}],"responses":{"200":{"description":"Interpretation details for number and context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NumberMeaningResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Compatibility and Lucky","security":[{"BearerAuth":[]}]}},"/v1/numerology/name-correction":{"post":{"tags":["Numerology"],"summary":"Name Correction Analysis","description":"Analyses a full name using Pythagorean numerology and suggests spelling variants that are more harmonious with the life path number. Returns current name scores and up to 8 alternatives ranked by harmony.","operationId":"get_name_correction_v1_numerology_name_correction_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameCorrectionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NameCorrectionResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Compatibility and Lucky","security":[{"BearerAuth":[]}]}},"/v1/numerology/chaldean":{"post":{"tags":["Numerology"],"summary":"Chaldean Numerology Profile","description":"Computes a full Chaldean numerology profile. Chaldean uses a different letter-value table than Pythagorean (numbers 1-8 only; 9 is sacred). Returns name number, birth number, and compound destiny number with interpretations.","operationId":"get_chaldean_v1_numerology_chaldean_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChaldeanRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_ChaldeanResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Alternative Systems","security":[{"BearerAuth":[]}]}},"/v1/numerology/lo-shu":{"post":{"tags":["Numerology"],"summary":"Lo Shu Grid","description":"Builds a Lo Shu 3x3 numerology grid from a birth date. Returns the grid with digit counts, present/missing/repeated numbers, plane analysis (thought/will/action), and per-number trait interpretation.","operationId":"get_lo_shu_v1_numerology_lo_shu_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoShuRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_LoShuResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Alternative Systems","security":[{"BearerAuth":[]}]}},"/v1/numerology/mobile-number":{"get":{"tags":["Numerology"],"summary":"Mobile Number Numerology","description":"Analyses a mobile/phone number numerologically. Sums all digits to a single number and returns theme, harmony score, and recommended uses.","operationId":"get_mobile_number_v1_numerology_mobile_number_get","parameters":[{"name":"number","in":"query","required":true,"schema":{"type":"string","minLength":5,"maxLength":20,"description":"Mobile number (digits only or with country code)","title":"Number"},"description":"Mobile number (digits only or with country code)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DigitNumberAnalysisResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Practical Numerology","security":[{"BearerAuth":[]}]}},"/v1/numerology/vehicle-number":{"get":{"tags":["Numerology"],"summary":"Vehicle Number Numerology","description":"Analyses a vehicle registration number numerologically. Extracts digits, sums to single number, returns theme and harmony score.","operationId":"get_vehicle_number_v1_numerology_vehicle_number_get","parameters":[{"name":"number","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":20,"description":"Vehicle registration number","title":"Number"},"description":"Vehicle registration number"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DigitNumberAnalysisResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Practical Numerology","security":[{"BearerAuth":[]}]}},"/v1/numerology/expression":{"post":{"tags":["Numerology"],"summary":"Expression (Destiny) Number","description":"Calculates the Expression (Destiny) number from the full name. Uses all letters with Pythagorean values, reducing each name part separately before summing (Goodwin method). Preserves master numbers 11, 22, 33.","operationId":"get_expression_number_v1_numerology_expression_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameOnlyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NameNumberResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Core Numbers","security":[{"BearerAuth":[]}]}},"/v1/numerology/soul-urge":{"post":{"tags":["Numerology"],"summary":"Soul Urge (Heart's Desire) Number","description":"Calculates the Soul Urge number from vowels (A, E, I, O, U) in the full name. Reduces each name part separately. Y is treated as a consonant in this implementation.","operationId":"get_soul_urge_number_v1_numerology_soul_urge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameOnlyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NameNumberResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Core Numbers","security":[{"BearerAuth":[]}]}},"/v1/numerology/personality":{"post":{"tags":["Numerology"],"summary":"Personality Number","description":"Calculates the Personality number from consonants in the full name. Reduces each name part separately. Represents the outer personality visible to others.","operationId":"get_personality_number_v1_numerology_personality_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameOnlyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NameNumberResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Core Numbers","security":[{"BearerAuth":[]}]}},"/v1/numerology/maturity":{"post":{"tags":["Numerology"],"summary":"Maturity (Realization) Number","description":"Calculates the Maturity number from Life Path + Expression. Represents the underlying wish or desire that surfaces around age 30-35. Requires both name and birth date.","operationId":"get_maturity_number_v1_numerology_maturity_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaturityNumberRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_MaturityNumberResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Core Numbers","security":[{"BearerAuth":[]}]}},"/v1/numerology/balance":{"post":{"tags":["Numerology"],"summary":"Balance Number","description":"Calculates the Balance number from the first letter of each name part. Indicates how a person handles stress and unresolved issues.","operationId":"get_balance_number_v1_numerology_balance_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameOnlyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NameNumberResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Core Numbers","security":[{"BearerAuth":[]}]}},"/v1/numerology/karmic-lessons":{"post":{"tags":["Numerology"],"summary":"Karmic Lessons","description":"Identifies karmic lessons from the name — the digit values 1-9 that are absent from the name's letter values. Missing numbers indicate areas requiring development in this lifetime.","operationId":"get_karmic_lessons_v1_numerology_karmic_lessons_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameOnlyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_KarmicLessonsResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Core Numbers","security":[{"BearerAuth":[]}]}},"/v1/numerology/personal-cycles":{"post":{"tags":["Numerology"],"summary":"Personal Year, Month, and Day","description":"Returns the Personal Year, Personal Month, and Personal Day numbers for a birth date and target date. Defaults to today if year/month/day not provided. Personal Day is only included when target day is provided.","operationId":"get_personal_cycles_v1_numerology_personal_cycles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalCycleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PersonalCycleResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Cycles and Timing","security":[{"BearerAuth":[]}]}},"/v1/numerology/angel/today":{"get":{"tags":["Numerology"],"summary":"Today's angel number","description":"Compute today's angel number from the current date. The date's digits are summed and reduced to a single digit (1-9), then the triple sequence of that digit is returned (e.g. digit 3 → angel number 333). The same number is returned for all callers on the same date.","operationId":"get_today_v1_numerology_angel_today_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_TodayAngelNumberResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/numerology/angel":{"get":{"tags":["Numerology","Numerology"],"summary":"List supported angel numbers","description":"Returns the curated set of angel-number patterns this API interprets. Use this endpoint to discover valid inputs for GET /v1/numerology/angel/{number}. Numbers outside this list (e.g. Pythagorean master numbers 11/22/33) are not part of the angel-number tradition and return 404 from the lookup endpoint.","operationId":"angel_numbers_list","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AngelNumbersListResponse"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/numerology/angel/{number}":{"get":{"tags":["Numerology"],"summary":"Angel number meaning","description":"Look up the meaning of a specific angel number. Supported numbers: 000, 111–999 (single repeating digit), 1010, 1111, 1122, 1212, 1234, 2222–9999 (double repeating digit), 911. Pass the number as a string path parameter, e.g. /v1/numerology/angel/444.","operationId":"get_number_v1_numerology_angel__number__get","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","title":"Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AngelNumberResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/numerology/angel/personal":{"post":{"tags":["Numerology"],"summary":"Personal angel number","description":"Compute your personal angel number from your birth date. Uses the Pythagorean Life Path number (digit-fusing method) as the base. Life Path 1-9 maps to the triple sequence (e.g. LP 4 → 444). Master numbers 11, 22, 33 map to 1111, 2222, 3333 respectively.","operationId":"get_personal_v1_numerology_angel_personal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalAngelNumberRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PersonalAngelNumberResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/crystals":{"get":{"tags":["Crystals"],"summary":"Complete crystal database","description":"Returns all 50 crystals in the database sorted alphabetically. Each entry includes chakra associations, elemental correspondences, Vedic and Western planetary assignments, healing properties, origins, affirmations, and safety cautions. Vedic correspondences are strictly separated: 'navaratna' (classical primary gem), 'uparatna' (classical substitute), or 'none_classical' (no Vedic text assigns this stone).","operationId":"get_crystals_v1_crystals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_CrystalListResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/crystals/by-planet/{planet}":{"get":{"tags":["Crystals"],"summary":"Crystals by Vedic planet","description":"Returns all crystals associated with a specific Vedic planet. Planets: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu. Results are sorted with primary Navaratna gems first, then Uparatna substitutes. Only Navaratna and Uparatna Vedic assignments are included — crystals without classical Vedic gemstone support are not returned here.","operationId":"get_by_planet_v1_crystals_by_planet__planet__get","parameters":[{"name":"planet","in":"path","required":true,"schema":{"type":"string","title":"Planet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_CrystalListResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/crystals/recommend":{"post":{"tags":["Crystals"],"summary":"Crystal recommendations","description":"Recommend crystals based on zodiac sign, chakra, or intention keyword. At least one filter must be provided. Providing multiple filters returns crystals that match the most criteria first. Valid chakras: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown. Returns up to `limit` crystals (default 5, max 20).","operationId":"get_recommendations_v1_crystals_recommend_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrystalRecommendRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_CrystalRecommendResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/crystals/recommend/natal":{"post":{"tags":["Crystals"],"summary":"Crystal recommendations from Vedic natal chart","description":"Recommend crystals based on gemstone house lordship rules. Computes the natal chart and identifies the planets that lord Trikona houses (1, 5, 9). Lagna lord = Life Stone (+5), Yogakaraka = supreme benefic (+5), 9th lord = Fortune Stone (+4), 5th lord = Lucky Stone (+3). Where a planet lords both a Trikona and a Dusthana (6, 8, 12), the Trikona Trikona lordship still prevails — the planet is still recommended. Planets not lordsing any Trikona house are contraindicated. Only crystals with classical Vedic assignments (Navaratna or Uparatna) are returned. Dangerous gem combinations are flagged in warnings[].","operationId":"get_natal_recommendations_v1_crystals_recommend_natal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NatalCrystalResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/crystals/{name}":{"get":{"tags":["Crystals"],"summary":"Single crystal lookup","description":"Lookup a specific crystal by slug or name (case-insensitive). Examples: 'amethyst', 'blue-sapphire', 'rose-quartz', 'Tiger's Eye'.","operationId":"get_crystal_v1_crystals__name__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_CrystalEntry_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/dreams/symbols":{"get":{"tags":["Dreams"],"summary":"Dream symbol database","description":"Returns all dream symbols from the database, optionally filtered by category. Each symbol includes dual-tradition interpretation: Jungian/Western psychological analysis and classical Vedic dream tradition meaning with auspiciousness rating. The traditions_agree field flags where Western and Vedic interpretations conflict. Categories: animals, nature, people, places, objects, actions, body, abstract.","operationId":"get_symbols_v1_dreams_symbols_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by category: animals, nature, people, places, objects, actions, body, abstract.","examples":["animals"],"title":"Category"},"description":"Filter by category: animals, nature, people, places, objects, actions, body, abstract."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DreamSymbolListResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/dreams/symbol/{name}":{"get":{"tags":["Dreams"],"summary":"Single dream symbol lookup","description":"Lookup a specific dream symbol by slug or name (case-insensitive). Examples: 'snake', 'eagle', 'childhood-home', 'teeth falling out'. Returns full dual-tradition interpretation including Jungian archetype, Vedic dream tradition meaning, context variants, and related symbols.","operationId":"get_symbol_v1_dreams_symbol__name__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DreamSymbol_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/tarot/cards":{"get":{"tags":["Tarot"],"summary":"All Tarot Cards","description":"Returns the complete 78-card Rider-Waite-Smith deck with full metadata. Each card includes id, name, arcana type, suit, element, astrological correspondence, upright and reversed meanings, keywords, yes/no polarity, and visual description. Use this endpoint to populate card databases, build card browsers, or reference individual card data.","operationId":"list_all_cards_v1_tarot_cards_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_TarotCardSchema__"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Deck","security":[{"BearerAuth":[]}]}},"/v1/tarot/cards/{card_id}":{"get":{"tags":["Tarot"],"summary":"Single Tarot Card","description":"Returns full data for a single card by its slug ID. Example IDs: 'the-fool', 'ace-of-wands', 'king-of-cups', 'the-world', 'ten-of-swords'.","operationId":"get_single_card_v1_tarot_cards__card_id__get","parameters":[{"name":"card_id","in":"path","required":true,"schema":{"type":"string","title":"Card Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_TarotCardSchema_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Deck","security":[{"BearerAuth":[]}]}},"/v1/tarot/major-arcana":{"get":{"tags":["Tarot"],"summary":"Major Arcana Cards","description":"Returns all 22 Major Arcana cards (The Fool through The World). Major Arcana represent archetypal life themes and major life events.","operationId":"list_major_arcana_v1_tarot_major_arcana_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_TarotCardSchema__"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Deck","security":[{"BearerAuth":[]}]}},"/v1/tarot/suits/{suit}":{"get":{"tags":["Tarot"],"summary":"Tarot Cards by Suit","description":"Returns all 14 cards in a given suit: wands, cups, swords, or pentacles. Wands=fire/career, Cups=water/emotions, Swords=air/intellect, Pentacles=earth/material.","operationId":"list_cards_by_suit_v1_tarot_suits__suit__get","parameters":[{"name":"suit","in":"path","required":true,"schema":{"type":"string","title":"Suit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_list_TarotCardSchema__"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Deck","security":[{"BearerAuth":[]}]}},"/v1/tarot/card-of-the-day":{"get":{"tags":["Tarot"],"summary":"Card of the Day","description":"Returns a deterministic daily tarot card. The same card is returned for all requests on the same date — seeded by SHA-256 hash of the date string. Optionally provide a date (YYYY-MM-DD) to get the card for any day. Defaults to today.","operationId":"get_daily_card_v1_tarot_card_of_the_day_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date in YYYY-MM-DD format. Defaults to today.","examples":["2026-05-01"],"title":"Date"},"description":"Date in YYYY-MM-DD format. Defaults to today."},{"name":"allow_reversed","in":"query","required":false,"schema":{"type":"boolean","description":"If true, the card may appear reversed (also deterministic by date).","default":false,"title":"Allow Reversed"},"description":"If true, the card may appear reversed (also deterministic by date)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_CardOfDayResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Draws","security":[{"BearerAuth":[]}]}},"/v1/tarot/draw":{"post":{"tags":["Tarot"],"summary":"Draw Tarot Cards","description":"Draw N random unique cards from the 78-card deck using cryptographic randomness. Each API call produces a fresh independent draw. Count must be between 1 and 78. Default: 1. Set allow_reversed=true to enable reversed card orientation (each card independently has a 50% chance of reversal).","operationId":"draw_v1_tarot_draw_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DrawRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_DrawResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Draws","security":[{"BearerAuth":[]}]}},"/v1/tarot/spread/three-card":{"post":{"tags":["Tarot"],"summary":"Three-Card Spread","description":"Past / Present / Future spread. Draws 3 unique cards and assigns them to positions: past (what led here), present (current situation), future (where this leads). Each position includes the card data, its orientation, the position meaning, and the active interpretation for that orientation.","operationId":"three_card_v1_tarot_spread_three_card_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpreadRequest"},"examples":{"Career question":{"summary":"Career reading","value":{"allow_reversed":true,"question":"What should I focus on in my career?"}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_SpreadResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Spreads","security":[{"BearerAuth":[]}]}},"/v1/tarot/spread/celtic-cross":{"post":{"tags":["Tarot"],"summary":"Celtic Cross Spread","description":"Full 10-card Celtic Cross spread — traditional ten-position tarot spread. Positions: present, challenge, root, past, possible outcome, near future, self, external influences, hopes and fears, final outcome. Returns each card with its spread position, position meaning, and active interpretation for the drawn orientation.","operationId":"celtic_cross_v1_tarot_spread_celtic_cross_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpreadRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_SpreadResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Spreads","security":[{"BearerAuth":[]}]}},"/v1/tarot/spread/yes-no":{"post":{"tags":["Tarot"],"summary":"Yes/No Tarot Reading","description":"Draw one card for a yes/no answer. Answer logic: yes-polarity card upright = 'yes' (strong). Yes-polarity card reversed = 'maybe' (leaning). No-polarity card upright = 'no' (strong). No-polarity card reversed = 'maybe' (leaning). Maybe-polarity card = 'maybe' (unclear). Reversed cards are enabled by default for this spread.","operationId":"yes_no_v1_tarot_spread_yes_no_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YesNoRequest"},"examples":{"Job offer question":{"summary":"Simple yes/no question","value":{"allow_reversed":true,"question":"Should I accept this job offer?"}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_YesNoResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Spreads","security":[{"BearerAuth":[]}]}},"/v1/astro/remedies":{"post":{"tags":["Astrology"],"summary":"Personalised Remedies","description":"Prescribes personalised Vedic remedies based on planetary dignity in the natal chart. Prioritises debilitated planets, planets in enemy signs, and dusthana lords (6th/8th/12th house rulers). Returns mantras, gemstones, colours, fasting days, and daily actions. Request JSON follows BirthInput: `name`, `date`, `time`, `location` or `latitude`/`longitude`/`timezone`, `ayanamsa`. Plus `top_n` (1–9) to cap how many planets receive remedy rows.","operationId":"get_remedies_v1_astro_remedies_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemediesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_RemediesResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Remedies and Rituals","security":[{"BearerAuth":[]}]}},"/v1/astro/gemstones":{"post":{"tags":["Astrology"],"summary":"Gemstone Recommendations","description":"Recommends gemstones based on the natal chart. Primary gemstone strengthens the Lagna lord. Secondary gemstone supports the Atmakaraka (soul planet). Returns contraindicated gemstones (debilitated, combust, dusthana lords, dual lagna/8th). Request JSON follows BirthInput: `name`, `date`, `time`, `location` or `latitude`/`longitude`/`timezone`, `ayanamsa`.","operationId":"get_gemstones_v1_astro_gemstones_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GemstoneRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_GemstoneResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Remedies and Rituals","security":[{"BearerAuth":[]}]}},"/v1/astro/ishta-devta":{"post":{"tags":["Astrology"],"summary":"Ishta Devta — Personal Deity","description":"Computes Ishta Devta (personal deity) from the 12th house lord of the Navamsa (D9) chart per Jaimini-tradition rules. Returns the ruling planet, associated deity, and D9 positions. Request JSON follows BirthInput: `name` (optional, default Chart), `date` (YYYY-MM-DD), `time` (HH:MM, required), either `location` or `latitude`/`longitude`/`timezone`, optional `ayanamsa` (lahiri|raman|kp|tropical).","operationId":"get_ishta_devta_v1_astro_ishta_devta_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IshtaDevtaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_IshtaDevtaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Chart Analysis","security":[{"BearerAuth":[]}]}},"/v1/astro/kp/chart":{"post":{"tags":["KP"],"summary":"KP Natal Chart","description":"Computes the KP (Krishnamurti Paddhati) natal chart using Krishnamurti ayanamsa and Placidus house system. Returns planet positions with nakshatra lord and sub-lord, and all 12 house cusps with sub-lords. Request JSON follows BirthInput: `name`, `date` (YYYY-MM-DD), `time` (HH:MM, required), either `location` or `latitude`/`longitude`/`timezone`, optional `ayanamsa`.","operationId":"get_kp_chart_v1_astro_kp_chart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KPBirthRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_KPChartResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"KP System","security":[{"BearerAuth":[]}]}},"/v1/astro/kp/significators":{"post":{"tags":["KP"],"summary":"KP House Significators","description":"Computes KP house significators for all 12 houses. For each house returns: occupants, sign lord, planets in nakshatra of occupants (level 3), and planets in nakshatra of the sign lord (level 4). Request JSON follows BirthInput: `name`, `date` (YYYY-MM-DD), `time` (HH:MM, required), either `location` or `latitude`/`longitude`/`timezone`, optional `ayanamsa`.","operationId":"get_kp_significators_v1_astro_kp_significators_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KPBirthRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_KPSignificatorsResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"KP System","security":[{"BearerAuth":[]}]}},"/v1/astro/kp/ruling-planets":{"post":{"tags":["KP"],"summary":"KP Ruling Planets","description":"Computes KP Ruling Planets at a given moment (no natal birth chart). Request body: `latitude`, `longitude`, optional `target_date`, `target_time`, `target_timezone`. Returns day lord, Moon sign/nakshatra/sub lords, ascendant sign/nakshatra/sub lords, and the combined list of ruling planets in priority order.","operationId":"get_kp_ruling_planets_v1_astro_kp_ruling_planets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KPRulingPlanetsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_KPRulingPlanetsResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"KP System","security":[{"BearerAuth":[]}]}},"/v1/astro/lal-kitab/chart":{"post":{"tags":["Lal Kitab"],"summary":"Lal Kitab Chart","description":"Computes a Lal Kitab chart using fixed sign=house mapping (Aries=House1, Taurus=House2, ..., Pisces=House12). Returns all 9 planets with Lal Kitab-specific flags: Pucca Ghar (permanent strong house), Kachcha Ghar (weak house), Uchcha (exaltation), and Neecha (debilitation). Lahiri ayanamsa always used.","operationId":"get_lal_kitab_chart_v1_astro_lal_kitab_chart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LalKitabRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_LalKitabChartResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Lal Kitab","security":[{"BearerAuth":[]}]}},"/v1/astro/lal-kitab/remedies":{"post":{"tags":["Lal Kitab"],"summary":"Lal Kitab Remedies","description":"Computes personalised Lal Kitab remedies from the birth chart. Returns practical remedies (donations, items to keep/bury, actions to avoid) for each planet based on its house placement. Malefic planets in Kachcha Ghar or Neecha are marked high priority.","operationId":"get_lal_kitab_remedies_v1_astro_lal_kitab_remedies_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LalKitabRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_LalKitabRemediesResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Lal Kitab","security":[{"BearerAuth":[]}]}},"/v1/astro/prashna":{"post":{"tags":["Prashna"],"summary":"Prashna (Horary Chart)","description":"Computes a Prashna (Horary) chart for the exact moment a question is asked. Returns lagna, Moon analysis, house lord condition, occupants of the relevant house, and a classical verdict (favourable / unfavourable / mixed) with confidence level. Question category determines which house is analysed.","operationId":"get_prashna_v1_astro_prashna_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PrashnaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Forecasting","security":[{"BearerAuth":[]}]}},"/v1/astro/nakshatra/{name}":{"get":{"tags":["Astrology"],"summary":"Nakshatra Profile","description":"Returns the complete classical profile for a given nakshatra: deity, ruling planet, gana, nature, body part, profession, life themes, strengths, challenges, favorable/unfavorable activities, and body map. Accepts nakshatra name in any case with spaces or underscores.","operationId":"get_nakshatra_v1_astro_nakshatra__name__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NakshatraProfileResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Foundations","security":[{"BearerAuth":[]}]}},"/v1/astro/planet-nature":{"get":{"tags":["Astrology"],"summary":"Graha Nature","description":"Returns classical graha properties for all nine planets or a single planet. Includes tattva, guna, gender, caste, direction, color, deity, ruling day, metal, body part governed, and naisargika maitri (natural friends, enemies, neutrals). Pass ?planet=Sun (or Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu) for a single planet. Omit ?planet to get all nine planets.","operationId":"get_planet_nature_endpoint_v1_astro_planet_nature_get","parameters":[{"name":"planet","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Planet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_Union_PlanetNatureAllResponse__PlanetNatureSingleResponse__"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Foundations","security":[{"BearerAuth":[]}]}},"/v1/astro/puja-suggestions":{"get":{"tags":["Astrology"],"summary":"Puja Suggestions","description":"Returns classical puja recommendations for planetary propitiation. Each planet has a specific puja, presiding deity, day of the week, offerings, grain, and mantra. Pass ?planet=Saturn for a single planet. Omit ?planet to get all nine planets.","operationId":"get_puja_endpoint_v1_astro_puja_suggestions_get","parameters":[{"name":"planet","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Planet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_Union_PujaSuggestionsAllResponse__PujaSuggestionSingleResponse__"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Remedies and Rituals","security":[{"BearerAuth":[]}]}},"/v1/astro/rudraksha":{"get":{"tags":["Astrology"],"summary":"Rudraksha Recommendations","description":"Returns Rudraksha bead recommendations per planet. Each planet maps to a specific mukhi (face count) with presiding deity, exact beej mantra, recommended metal, wearing day, and classical notes including the important distinction that mukhi assignments are attributed to deities in tradition — planetary correspondence is traditional astrological synthesis. Pass ?planet=Jupiter for a single planet. Omit ?planet to get all nine planets.","operationId":"get_rudraksha_endpoint_v1_astro_rudraksha_get","parameters":[{"name":"planet","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Planet"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_Union_RudrakshaAllResponse__RudrakshaSingleResponse__"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Remedies and Rituals","security":[{"BearerAuth":[]}]}},"/v1/astro/ayanamsha":{"get":{"tags":["Astrology"],"summary":"Ayanamsha Values","description":"Returns ayanamsha values for all four supported systems (Lahiri, Raman, KP, Tropical) for a given date. Each system returns the value in decimal degrees and DMS (degrees/minutes/seconds) format. Pass ?date=YYYY-MM-DD for a specific date. Omit ?date to get today's values. Lahiri is the Indian government standard and default for Jyotish.","operationId":"get_ayanamsha_endpoint_v1_astro_ayanamsha_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_AyanamshaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Foundations","security":[{"BearerAuth":[]}]}},"/v1/western/biorhythm":{"post":{"tags":["Western"],"summary":"Biorhythm Cycles","description":"Computes physical (23-day), emotional (28-day), and intellectual (33-day) biorhythm cycles for a birth date. Returns cycle values (-1.0 to +1.0), percentage, phase label (High/Rising/Falling/Low), and critical day flags. Critical days occur when a cycle crosses zero — these represent instability and vulnerability to poor judgment. Supports single-day and multi-day (up to 90 days) range requests. Formula: sin(2π × t / cycle_length) where t = days since birth. Source: Wilhelm Fliess (1897) physical cycle; Hermann Swoboda (1900) emotional cycle; Alfred Teltscher (1926) intellectual cycle.","operationId":"compute_biorhythm_endpoint_v1_western_biorhythm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiorhythmRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_Union_BiorhythmSingleDayResponse__BiorhythmRangeResponse__"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Moon and Cycles","security":[{"BearerAuth":[]}]}},"/v1/astro/nakshatra/prediction":{"post":{"tags":["Astrology"],"summary":"Personal Nakshatra Prediction (Tarabala)","description":"Returns a personalised daily prediction using Tarabala and Chandrabala. Tarabala measures the auspiciousness of the current day for an individual by assessing the relationship between their natal Moon nakshatra and the daily transit Moon nakshatra. Nine Taras from Janma (birth) to Ati-Mitra (great friend). Chandrabala measures the transit Moon's house from natal Moon. Also returns the transit nakshatra's quality type (Dhruva/Chara/ Ugra/Tikshna/Kshipra/Mridu/Mishra) with auspicious and inauspicious activities for today.","operationId":"nakshatra_prediction_endpoint_v1_astro_nakshatra_prediction_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NakshatraPredictionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_NakshatraPredictionResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Forecasting","security":[{"BearerAuth":[]}]}},"/v1/astro/pitra-dosha":{"post":{"tags":["Astrology"],"summary":"Pitru Dosha (Pitru Shapa)","description":"Detects and analyses Pitru Dosha (Pitru Shapa — Ancestral Curse) from the natal chart using all five classical combinations that indicate Pitru Dosha presence. Returns presence flag, severity (mild/moderate/severe), which of the 5 classical combinations are triggered, Sun and 9th lord analysis, afflicting planets, cancellation conditions (Jupiter protective), classical symptoms, and classical remedies. Primary classical symptom: denial of progeny or difficulties with children. This is a standalone endpoint providing deeper analysis than the pitru_dosha field in /v1/astro/doshas.","operationId":"get_pitru_dosha_v1_astro_pitra_dosha_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_PitruDoshaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Yogas and Doshas","security":[{"BearerAuth":[]}]}},"/v1/astro/ghat-chakra":{"post":{"tags":["Astrology"],"summary":"Ghat Chakra","description":"Returns the four Ghatak (inauspicious) timing parameters for a native based on their Janma Rasi (natal Moon sign). Ghat Chakra identifies the lunar month (Masa), lunar day group (Tithi), weekday (Vara), and transit nakshatra that are persistently inauspicious for that individual. When transit periods align with these Ghatak parameters, starting new ventures, surgery, travel, or auspicious ceremonies should be avoided.","operationId":"get_ghat_chakra_endpoint_v1_astro_ghat_chakra_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_GhatChakraResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Yogas and Doshas","security":[{"BearerAuth":[]}]}},"/v1/utils/geocode":{"get":{"tags":["Utilities"],"summary":"Resolve a city or place name to latitude, longitude, and timezone","description":"Resolve a city or place name to coordinates and timezone.\n\nReturns up to {limit} matches. When a query is ambiguous\n(e.g. 'Fatehabad' exists in multiple states), multiple results\nare returned so the developer can present a disambiguation UI\nor use the first result.\n\nExamples: ?q=Mumbai, ?q=Rome Italy, ?q=New York USA, ?q=London UK\n\nPass state/country for precise results:\n?q=Fatehabad,Haryana or ?q=Fatehabad&country=in","operationId":"geocode_v1_utils_geocode_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"City or location name. Use comma for disambiguation: 'Fatehabad,Haryana'","title":"Q"},"description":"City or location name. Use comma for disambiguation: 'Fatehabad,Haryana'"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"description":"Maximum results to return","default":5,"title":"Limit"},"description":"Maximum results to return"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO country code to narrow results, e.g. 'in', 'us'","title":"Country"},"description":"ISO country code to narrow results, e.g. 'in', 'us'"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_GeocodeResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/utils/timezone":{"get":{"tags":["Utilities"],"summary":"Return the IANA timezone for a given coordinate pair","description":"Get IANA timezone for a coordinate pair.\nFully offline — no external API call.\nAccepts ?latitude=&longitude= and/or ?lat=&lon= (any pair that supplies both coordinates).\nExamples: ?latitude=19.055&longitude=72.869 (Mumbai), ?lat=19.055&lon=72.869","operationId":"timezone_from_coordinates_v1_utils_timezone_get","parameters":[{"name":"latitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Latitude (alias: lat)","title":"Latitude"},"description":"Latitude (alias: lat)"},{"name":"longitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Longitude (alias: lon)","title":"Longitude"},"description":"Longitude (alias: lon)"},{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Alias for latitude","title":"Lat"},"description":"Alias for latitude"},{"name":"lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Alias for longitude","title":"Lon"},"description":"Alias for longitude"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_TimezoneResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/astro/sade-sati":{"post":{"tags":["Astrology"],"summary":"Sade Sati periods","description":"Calculate all Sade Sati periods for a natal chart. Returns rising, peak, and setting phases for each period, current active status, intensity score (0-100), intensity label, and next upcoming period. Optionally check status for a specific date using check_date. Sade Sati is Saturn's 7.5-year transit over natal Moon sign and adjacent signs. Small Panoti (Dhaiya) covers Saturn in the 4th or 8th sign from natal Moon (~2.5 years each). Returns all past, current, and future Sade Sati cycles with phase descriptions.","operationId":"get_sade_sati_v1_astro_sade_sati_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SadeSatiRequest"},"examples":{"India — Arjun Mehta":{"summary":"Birth chart for Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"}},"Europe — Sofia Rossi":{"summary":"Birth chart for Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}},"Americas — James Carter":{"summary":"Birth chart for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"Sade Sati status, phases, timing, and intensity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_SadeSatiResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Yogas and Doshas","security":[{"BearerAuth":[]}]}},"/v1/astro/strength":{"post":{"tags":["Advanced"],"summary":"Calculate planetary strength suite","description":"Builds a composite strength report including shadbala, divisional charts, ashtakavarga, and karakas from birth input. Requires authenticated API key access (Vedic tier or above in product terms). Returns a unified strength payload for all supported modules.","operationId":"get_strength_report_v1_astro_strength_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrengthRequest"},"examples":{"India — Arjun Mehta":{"summary":"Birth chart for Arjun Mehta, Mumbai","value":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai","ayanamsa":"lahiri"}},"Europe — Sofia Rossi":{"summary":"Birth chart for Sofia Rossi, Rome","value":{"name":"Sofia Rossi","date":"1990-06-21","time":"15:30","location":"Rome, Italy","ayanamsa":"lahiri"}},"Americas — James Carter":{"summary":"Birth chart for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"Composite strength report across astrology modules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_StrengthResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Chart Analysis","security":[{"BearerAuth":[]}]}},"/v1/astro/transits":{"post":{"tags":["Advanced"],"summary":"Planetary transits — Gochar","description":"Scans a date range for planetary sign ingresses and retrograde/direct station events. Requires authenticated API key access (Vedic tier or above in product terms). Returns grouped transit events for supported planets. Also known as Gochar. Returns planetary sign ingresses and retrograde/direct station events for a given date range.","operationId":"get_transits_v1_astro_transits_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitsRequest"},"examples":{"2026 transits":{"summary":"All planetary transits for 2026","value":{"from_date":"2026-01-01T00:00:00Z","to_date":"2026-12-31T23:59:59Z"}}}}},"required":true},"responses":{"200":{"description":"Transit ingress and station event collections","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_TransitsResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Forecasting","security":[{"BearerAuth":[]}]}},"/v1/astro/yogini":{"post":{"tags":["Advanced"],"summary":"Yogini Dasha","description":"Computes Yogini Dasha periods for a given birth chart.\n\n**What is Yogini Dasha?**\nYogini Dasha is a Nakshatra-based dasha system using 8 Yoginis, each ruled \nby a planet. The total cycle is 36 years. It is considered highly accurate \nfor timing events in the near term and is widely used alongside Vimshottari.\n\n**The 8 Yoginis and their durations:**\n- Mangala (Moon) — 1 year\n- Pingala (Sun) — 2 years\n- Dhanya (Jupiter) — 3 years\n- Bhramari (Mars) — 4 years\n- Bhadrika (Mercury) — 5 years\n- Ulka (Saturn) — 6 years\n- Siddha (Venus) — 7 years\n- Sankata (Rahu) — 8 years\n\n**Starting Yogini** is determined by the Moon's Nakshatra at birth.\n\n**Levels:**\n- `levels: 1` — returns Maha Dasha periods only\n- `levels: 2` — returns Maha Dasha with Antar Dasha sub-periods (default)\n\n**Date format:** All dates are returned in DD/MM/YYYY format.\n\n**Ayanamsa:** Default is Lahiri.","operationId":"yogini_dasha_v1_astro_yogini_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YoginiRequest"},"examples":{"Americas — James Carter":{"summary":"Yogini Dasha for James Carter, New York","value":{"name":"James Carter","date":"1983-03-08","time":"09:15","location":"New York, USA","ayanamsa":"lahiri"}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_YoginiEndpointResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Dashas","security":[{"BearerAuth":[]}]}},"/v1/astro/varshaphal":{"post":{"tags":["Astrology"],"summary":"Varshaphal — Solar Return Chart","description":"Computes the Varshaphal (annual horoscope) for a given year. Finds the exact moment when the Sun returns to its natal longitude, computes all planet positions at that moment, and returns Muntha (progressed ascendant) and Varsha Lord (year lord). Request JSON follows BirthInput plus `target_year`: `name`, `date` (YYYY-MM-DD), `time` (HH:MM, required), either `location` or `latitude`/`longitude`/`timezone`, `ayanamsa`.","operationId":"get_varshaphal_v1_astro_varshaphal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VarshaphalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_VarshaphalResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Forecasting","security":[{"BearerAuth":[]}]}},"/v1/astro/varshaphal/saham":{"post":{"tags":["Astrology"],"summary":"Varshaphal — Tajika Saham Points","description":"Computes all 10 Tajika Saham (sensitive points) for a Varshaphal chart. Sahams are the Tajika equivalent of Arabic Parts — mathematically derived points that focus on specific life themes for the year. Formula: A - B + Ascendant (conditional +30° per Tajika Saham rules). Day and night formulas differ — the operands swap based on whether the solar return occurs during daytime or nighttime. 10 Sahams returned: Punya (Fortune), Vidya (Education), Yashas (Fame), Mitra (Friends), Mahatmya (Status), Asha (Desires), Karmakarya (Career), Vyapara (Business), Vivaha (Marriage), Santapa (Sorrow/Stress). Yashas and Mahatmya use Punya Saham as an operand — computed first.","operationId":"get_varshaphal_saham_v1_astro_varshaphal_saham_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VarshaphalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_SahamResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Forecasting","security":[{"BearerAuth":[]}]}},"/v1/astro/varshaphal/harsha-bala":{"post":{"tags":["Astrology"],"summary":"Varshaphal — Harsha Bala","description":"Computes Harsha Bala (positional happiness score) for all 7 classical planets in the Varshaphal chart. Maximum = 20 per planet (4 components × 5 points). Harsha Bala measures whether a planet is positionally comfortable in the annual chart — distinct from Pancha Vargeeya Bala which measures mathematical strength. A planet with high Pancha Vargeeya Bala but zero Harsha Bala has the capacity to deliver results but will do so through stress and frustration. Components: Sthana (happy house placement), Swakshetra/Uccha (own or exaltation sign), Pum-Stri (gender-appropriate house hemisphere), Dina-Ratri (day/night return alignment). Computed per Tajika rules.","operationId":"get_harsha_bala_v1_astro_varshaphal_harsha_bala_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VarshaphalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse_HarshaBalaResponse_"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authorization failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream provider error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-subcategory":"Forecasting","security":[{"BearerAuth":[]}]}}},"components":{"schemas":{"AngelNumberResponse":{"properties":{"number":{"type":"string","title":"Number","description":"Angel number sequence, e.g. '111', '1111'."},"theme":{"type":"string","title":"Theme","description":"Core theme of this angel number."},"message":{"type":"string","title":"Message","description":"Primary message of this angel number."},"guidance":{"type":"string","title":"Guidance","description":"Actionable guidance for this number."},"areas":{"items":{"type":"string"},"type":"array","title":"Areas","description":"Life areas associated with this number."}},"type":"object","required":["number","theme","message","guidance","areas"],"title":"AngelNumberResponse"},"AngelNumbersListData":{"properties":{"count":{"type":"integer","title":"Count"},"numbers":{"items":{"type":"string"},"type":"array","title":"Numbers"},"note":{"type":"string","title":"Note"}},"type":"object","required":["count","numbers","note"],"title":"AngelNumbersListData"},"AngelNumbersListResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"$ref":"#/components/schemas/AngelNumbersListData"}},"type":"object","required":["success","message","data"],"title":"AngelNumbersListResponse"},"ApiResponse_AngelNumberResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/AngelNumberResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[AngelNumberResponse]"},"ApiResponse_AshtakavargaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/AshtakavargaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[AshtakavargaResponse]"},"ApiResponse_AshtottariEndpointResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/AshtottariEndpointResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[AshtottariEndpointResponse]"},"ApiResponse_AtmakarakaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/AtmakarakaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[AtmakarakaResponse]"},"ApiResponse_AyanamshaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/AyanamshaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[AyanamshaResponse]"},"ApiResponse_BusinessNameAnalysisResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/BusinessNameAnalysisResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[BusinessNameAnalysisResponse]"},"ApiResponse_CardOfDayResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/CardOfDayResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[CardOfDayResponse]"},"ApiResponse_ChaldeanResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/ChaldeanResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[ChaldeanResponse]"},"ApiResponse_CharDashaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/CharDashaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[CharDashaResponse]"},"ApiResponse_ChartResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/ChartResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[ChartResponse]"},"ApiResponse_ChoghadiyaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/ChoghadiyaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[ChoghadiyaResponse]"},"ApiResponse_CompositeResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/CompositeResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[CompositeResponse]"},"ApiResponse_CrystalEntry_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/CrystalEntry","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[CrystalEntry]"},"ApiResponse_CrystalListResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/CrystalListResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[CrystalListResponse]"},"ApiResponse_CrystalRecommendResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/CrystalRecommendResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[CrystalRecommendResponse]"},"ApiResponse_DailyTransitResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/DailyTransitResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[DailyTransitResponse]"},"ApiResponse_DashaEndpointResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/DashaEndpointResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[DashaEndpointResponse]"},"ApiResponse_DashaTransitsResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/DashaTransitsResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[DashaTransitsResponse]"},"ApiResponse_DashakootResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/DashakootResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[DashakootResponse]"},"ApiResponse_DigitNumberAnalysisResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/DigitNumberAnalysisResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[DigitNumberAnalysisResponse]"},"ApiResponse_DivisionalResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/DivisionalResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[DivisionalResponse]"},"ApiResponse_DoshaEndpointResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/DoshaEndpointResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[DoshaEndpointResponse]"},"ApiResponse_DrawResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/DrawResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[DrawResponse]"},"ApiResponse_DreamSymbolListResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/DreamSymbolListResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[DreamSymbolListResponse]"},"ApiResponse_DreamSymbol_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/DreamSymbol","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[DreamSymbol]"},"ApiResponse_FestivalCalendarResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/FestivalCalendarResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[FestivalCalendarResponse]"},"ApiResponse_GemstoneResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/GemstoneResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[GemstoneResponse]"},"ApiResponse_GeocodeResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/GeocodeResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[GeocodeResponse]"},"ApiResponse_GhatChakraResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/GhatChakraResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[GhatChakraResponse]"},"ApiResponse_GocharResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/GocharResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[GocharResponse]"},"ApiResponse_HarshaBalaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/HarshaBalaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[HarshaBalaResponse]"},"ApiResponse_HoraResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/HoraResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[HoraResponse]"},"ApiResponse_HoroscopeData_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/HoroscopeData","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[HoroscopeData]"},"ApiResponse_IshtaDevtaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/IshtaDevtaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[IshtaDevtaResponse]"},"ApiResponse_KPChartResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/KPChartResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[KPChartResponse]"},"ApiResponse_KPRulingPlanetsResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/KPRulingPlanetsResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[KPRulingPlanetsResponse]"},"ApiResponse_KPSignificatorsResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/KPSignificatorsResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[KPSignificatorsResponse]"},"ApiResponse_KarmicLessonsResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/KarmicLessonsResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[KarmicLessonsResponse]"},"ApiResponse_LalKitabChartResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/LalKitabChartResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[LalKitabChartResponse]"},"ApiResponse_LalKitabRemediesResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/LalKitabRemediesResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[LalKitabRemediesResponse]"},"ApiResponse_LifePathResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/LifePathResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[LifePathResponse]"},"ApiResponse_LoShuResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/LoShuResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[LoShuResponse]"},"ApiResponse_LuckyNumbersApiResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/LuckyNumbersApiResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[LuckyNumbersApiResponse]"},"ApiResponse_MatchmakingResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/MatchmakingResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[MatchmakingResponse]"},"ApiResponse_MaturityNumberResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/MaturityNumberResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[MaturityNumberResponse]"},"ApiResponse_MonthlyTransitResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/MonthlyTransitResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[MonthlyTransitResponse]"},"ApiResponse_MoonPhaseResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/MoonPhaseResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[MoonPhaseResponse]"},"ApiResponse_MuhurtaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/MuhurtaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[MuhurtaResponse]"},"ApiResponse_NakshatraPredictionResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/NakshatraPredictionResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[NakshatraPredictionResponse]"},"ApiResponse_NakshatraProfileResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/NakshatraProfileResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[NakshatraProfileResponse]"},"ApiResponse_NameCorrectionResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/NameCorrectionResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[NameCorrectionResponse]"},"ApiResponse_NameNumberResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/NameNumberResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[NameNumberResponse]"},"ApiResponse_NatalCrystalResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/NatalCrystalResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[NatalCrystalResponse]"},"ApiResponse_NatalResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/NatalResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[NatalResponse]"},"ApiResponse_NumberMeaningResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/NumberMeaningResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[NumberMeaningResponse]"},"ApiResponse_NumerologyProfileResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/NumerologyProfileResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[NumerologyProfileResponse]"},"ApiResponse_PanchangaCalendarResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/PanchangaCalendarResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[PanchangaCalendarResponse]"},"ApiResponse_PanchangaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/PanchangaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[PanchangaResponse]"},"ApiResponse_PapasamyamResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/PapasamyamResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[PapasamyamResponse]"},"ApiResponse_PersonalAngelNumberResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/PersonalAngelNumberResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[PersonalAngelNumberResponse]"},"ApiResponse_PersonalCycleResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/PersonalCycleResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[PersonalCycleResponse]"},"ApiResponse_PersonalYearResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/PersonalYearResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[PersonalYearResponse]"},"ApiResponse_PitruDoshaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/PitruDoshaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[PitruDoshaResponse]"},"ApiResponse_PoruthamResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/PoruthamResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[PoruthamResponse]"},"ApiResponse_PrashnaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/PrashnaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[PrashnaResponse]"},"ApiResponse_RahuKaalResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/RahuKaalResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[RahuKaalResponse]"},"ApiResponse_RemediesResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/RemediesResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[RemediesResponse]"},"ApiResponse_ReturnChartResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/ReturnChartResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[ReturnChartResponse]"},"ApiResponse_SadeSatiResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/SadeSatiResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[SadeSatiResponse]"},"ApiResponse_SahamResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/SahamResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[SahamResponse]"},"ApiResponse_SecondaryProgressionResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/SecondaryProgressionResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[SecondaryProgressionResponse]"},"ApiResponse_SolarArcResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/SolarArcResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[SolarArcResponse]"},"ApiResponse_SpreadResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/SpreadResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[SpreadResponse]"},"ApiResponse_StrengthResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/StrengthResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[StrengthResponse]"},"ApiResponse_SynastryResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/SynastryResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[SynastryResponse]"},"ApiResponse_TamilPanchangaResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/TamilPanchangaResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[TamilPanchangaResponse]"},"ApiResponse_TarotCardSchema_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/TarotCardSchema","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[TarotCardSchema]"},"ApiResponse_ThirumanaPoruthamResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/ThirumanaPoruthamResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[ThirumanaPoruthamResponse]"},"ApiResponse_TimezoneResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/TimezoneResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[TimezoneResponse]"},"ApiResponse_TodayAngelNumberResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/TodayAngelNumberResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[TodayAngelNumberResponse]"},"ApiResponse_TransitsResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/TransitsResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[TransitsResponse]"},"ApiResponse_Union_BiorhythmSingleDayResponse__BiorhythmRangeResponse__":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"anyOf":[{"$ref":"#/components/schemas/BiorhythmSingleDayResponse"},{"$ref":"#/components/schemas/BiorhythmRangeResponse"}],"title":"Data","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[Union[BiorhythmSingleDayResponse, BiorhythmRangeResponse]]"},"ApiResponse_Union_PlanetNatureAllResponse__PlanetNatureSingleResponse__":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"anyOf":[{"$ref":"#/components/schemas/PlanetNatureAllResponse"},{"$ref":"#/components/schemas/PlanetNatureSingleResponse"}],"title":"Data","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[Union[PlanetNatureAllResponse, PlanetNatureSingleResponse]]"},"ApiResponse_Union_PujaSuggestionsAllResponse__PujaSuggestionSingleResponse__":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"anyOf":[{"$ref":"#/components/schemas/PujaSuggestionsAllResponse"},{"$ref":"#/components/schemas/PujaSuggestionSingleResponse"}],"title":"Data","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[Union[PujaSuggestionsAllResponse, PujaSuggestionSingleResponse]]"},"ApiResponse_Union_RudrakshaAllResponse__RudrakshaSingleResponse__":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"anyOf":[{"$ref":"#/components/schemas/RudrakshaAllResponse"},{"$ref":"#/components/schemas/RudrakshaSingleResponse"}],"title":"Data","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[Union[RudrakshaAllResponse, RudrakshaSingleResponse]]"},"ApiResponse_VarshaphalResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/VarshaphalResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[VarshaphalResponse]"},"ApiResponse_WeeklyTransitResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/WeeklyTransitResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[WeeklyTransitResponse]"},"ApiResponse_WesternAspectsResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/WesternAspectsResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[WesternAspectsResponse]"},"ApiResponse_WesternHoroscopeData_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/WesternHoroscopeData","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[WesternHoroscopeData]"},"ApiResponse_WesternNatalResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/WesternNatalResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[WesternNatalResponse]"},"ApiResponse_YesNoResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/YesNoResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[YesNoResponse]"},"ApiResponse_YogaEndpointResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/YogaEndpointResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[YogaEndpointResponse]"},"ApiResponse_YoginiEndpointResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/YoginiEndpointResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[YoginiEndpointResponse]"},"ApiResponse_ZodiacCompatibilityResponse_":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/ZodiacCompatibilityResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[ZodiacCompatibilityResponse]"},"ApiResponse_list_MoonPhaseResponse__":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"items":{"$ref":"#/components/schemas/MoonPhaseResponse"},"type":"array","title":"Data","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[list[MoonPhaseResponse]]"},"ApiResponse_list_TarotCardSchema__":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"items":{"$ref":"#/components/schemas/TarotCardSchema"},"type":"array","title":"Data","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[list[TarotCardSchema]]"},"AshtakavargaRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"AshtakavargaRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"AshtakavargaResponse":{"properties":{"bhinna":{"additionalProperties":{"additionalProperties":{"type":"integer"},"type":"object"},"type":"object","title":"Bhinna","description":"Bhinna Ashtakavarga (BAV) for each planet plus Lagna. Keys: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Lagna. Each value maps Sanskrit sign name (Mesha…Meena) to bindu count for that sign."},"bhinna_after_trikona":{"additionalProperties":{"additionalProperties":{"type":"integer"},"type":"object"},"type":"object","title":"Bhinna After Trikona","description":"BAV after Trikona Shodana (triangular reduction). Keys: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn. Each value maps Sanskrit sign name to bindu count."},"bhinna_after_ekadhipatya":{"additionalProperties":{"additionalProperties":{"type":"integer"},"type":"object"},"type":"object","title":"Bhinna After Ekadhipatya","description":"BAV after both Trikona and Ekadhipatya Shodana (lordship reduction). Keys: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn. Each value maps Sanskrit sign name to bindu count. This is the most refined per-planet Ashtakavarga."},"sarva":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sarva","description":"Sarva Ashtakavarga (SAV) — the raw sum of all 7 planet BAVs across 12 signs. Keys: Mesha through Meena."},"sarva_reduced":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sarva Reduced","description":"Reduced SAV — sum of the 7 fully reduced planet BAVs (after both Trikona and Ekadhipatya Shodana). Keys: Mesha through Meena. More accurate than sarva for predictive work."},"after_trikona":{"additionalProperties":{"type":"integer"},"type":"object","title":"After Trikona","description":"SAV after Trikona Shodana applied directly to the raw SAV. Keys: Mesha through Meena."},"after_ekadhipatya":{"additionalProperties":{"type":"integer"},"type":"object","title":"After Ekadhipatya","description":"SAV after both Trikona and Ekadhipatya Shodana applied directly to the raw SAV. Keys: Mesha through Meena."},"birth_time_provided":{"type":"boolean","title":"Birth Time Provided","description":"Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.","default":true}},"type":"object","required":["bhinna","bhinna_after_trikona","bhinna_after_ekadhipatya","sarva","sarva_reduced","after_trikona","after_ekadhipatya"],"title":"AshtakavargaResponse"},"AshtottariEndpointResponse":{"properties":{"periods":{"$ref":"#/components/schemas/AshtottariResponse"},"birth_time_provided":{"type":"boolean","title":"Birth Time Provided","description":"Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.","default":true}},"type":"object","required":["periods"],"title":"AshtottariEndpointResponse"},"AshtottariPeriod":{"properties":{"planet":{"type":"string","title":"Planet","description":"Planetary lord of this Dasha period"},"start_jd":{"type":"number","title":"Start Jd","description":"Start of period as Julian Day number"},"end_jd":{"type":"number","title":"End Jd","description":"End of period as Julian Day number"},"start_date":{"type":"string","title":"Start Date","description":"Start date in DD/MM/YYYY format"},"end_date":{"type":"string","title":"End Date","description":"End date in DD/MM/YYYY format"},"sub":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Sub","description":"Sub-periods (Antar Dasha). Present only when levels=2."}},"type":"object","required":["planet","start_jd","end_jd","start_date","end_date"],"title":"AshtottariPeriod"},"AshtottariRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"levels":{"type":"integer","maximum":2.0,"minimum":1.0,"title":"Levels","description":"Depth of sub-periods to return. 1 returns Maha Dashas only. 2 returns Maha and Antar Dashas. Maximum is 2.","default":2}},"type":"object","required":["date"],"title":"AshtottariRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"AshtottariResponse":{"properties":{"root":{"items":{"$ref":"#/components/schemas/AshtottariPeriod"},"type":"array","title":"Root"}},"type":"object","required":["root"],"title":"AshtottariResponse"},"AtmakarakaRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"AtmakarakaRequest","description":"Jaimini Charakarakas — extends :class:`BirthInput`.\n\nInherits: ``name``, ``date`` (YYYY-MM-DD), ``time`` (HH:MM, required for this API),\n``location`` *or* ``latitude``, ``longitude``, ``timezone``, ``ayanamsa``.","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"AtmakarakaResponse":{"properties":{"karaka_to_planet":{"additionalProperties":{"type":"string"},"type":"object","title":"Karaka To Planet"},"planet_to_karaka":{"additionalProperties":{"type":"string"},"type":"object","title":"Planet To Karaka"},"atmakaraka":{"type":"string","title":"Atmakaraka"},"atmakaraka_sign":{"type":"string","title":"Atmakaraka Sign"},"atmakaraka_nakshatra":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Atmakaraka Nakshatra"},"details":{"additionalProperties":true,"type":"object","title":"Details"}},"type":"object","required":["karaka_to_planet","planet_to_karaka","atmakaraka","atmakaraka_sign","atmakaraka_nakshatra","details"],"title":"AtmakarakaResponse"},"AyanamshaResponse":{"properties":{"date":{"type":"string","title":"Date","description":"Date in ISO YYYY-MM-DD format"},"ayanamsha":{"additionalProperties":{"$ref":"#/components/schemas/AyanamshaSystemValue"},"type":"object","title":"Ayanamsha","description":"Ayanamsha values keyed by system name (lahiri, raman, kp, tropical)"},"note":{"type":"string","title":"Note"}},"type":"object","required":["date","ayanamsha","note"],"title":"AyanamshaResponse"},"AyanamshaSystemValue":{"properties":{"value_decimal":{"type":"number","title":"Value Decimal","description":"Ayanamsha offset in decimal degrees"},"degrees":{"type":"integer","title":"Degrees"},"minutes":{"type":"integer","title":"Minutes"},"seconds":{"type":"number","title":"Seconds"},"dms":{"type":"string","title":"Dms","description":"Degrees, minutes, seconds formatted string"},"description":{"type":"string","title":"Description"}},"type":"object","required":["value_decimal","degrees","minutes","seconds","dms","description"],"title":"AyanamshaSystemValue"},"BhavaMadhyaEntry":{"properties":{"house":{"type":"integer","title":"House","description":"House number 1-12"},"sign":{"type":"string","title":"Sign","description":"Sanskrit sign name"},"sign_num":{"type":"integer","title":"Sign Num","description":"Sign index 0-11"},"degree":{"type":"number","title":"Degree","description":"Ecliptic longitude in degrees"}},"type":"object","required":["house","sign","sign_num","degree"],"title":"BhavaMadhyaEntry"},"BiorhythmCycleDetail":{"properties":{"value":{"type":"number","title":"Value","description":"Cycle value from -1.0 to +1.0"},"percentage":{"type":"number","title":"Percentage","description":"Cycle value as percentage"},"phase":{"type":"string","title":"Phase","description":"Phase label: High, Rising, Falling, or Low"},"is_critical":{"type":"boolean","title":"Is Critical","description":"True when the cycle crosses zero"},"cycle_length_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cycle Length Days","description":"Cycle length in days (present on single-day responses)"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Cycle description (present on single-day responses)"}},"type":"object","required":["value","percentage","phase","is_critical"],"title":"BiorhythmCycleDetail"},"BiorhythmDailyEntry":{"properties":{"date":{"type":"string","title":"Date"},"cycles":{"additionalProperties":{"$ref":"#/components/schemas/BiorhythmCycleDetail"},"type":"object","title":"Cycles"},"critical":{"items":{"type":"string"},"type":"array","title":"Critical"},"composite_score":{"type":"number","title":"Composite Score"}},"type":"object","required":["date","cycles","critical","composite_score"],"title":"BiorhythmDailyEntry"},"BiorhythmRangeResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"days":{"type":"integer","title":"Days"},"daily":{"items":{"$ref":"#/components/schemas/BiorhythmDailyEntry"},"type":"array","title":"Daily"},"note":{"type":"string","title":"Note"}},"type":"object","required":["birth_date","start_date","end_date","days","daily","note"],"title":"BiorhythmRangeResponse"},"BiorhythmRequest":{"properties":{"birth_date":{"type":"string","format":"date","title":"Birth Date","description":"Date of birth in YYYY-MM-DD format.","examples":["1985-11-12"]},"target_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Target Date","description":"Date to compute cycles for. Defaults to today.","examples":["2026-05-02"]},"days":{"type":"integer","maximum":90.0,"minimum":1.0,"title":"Days","description":"Number of consecutive days to compute (1-90). Use 1 for a single day snapshot. Use >1 for a date range.","default":1}},"type":"object","required":["birth_date"],"title":"BiorhythmRequest"},"BiorhythmSingleDayResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"target_date":{"type":"string","title":"Target Date"},"days_since_birth":{"type":"integer","title":"Days Since Birth"},"cycles":{"additionalProperties":{"$ref":"#/components/schemas/BiorhythmCycleDetail"},"type":"object","title":"Cycles"},"critical_today":{"items":{"type":"string"},"type":"array","title":"Critical Today"},"has_critical_day":{"type":"boolean","title":"Has Critical Day"},"composite_score":{"type":"number","title":"Composite Score"},"note":{"type":"string","title":"Note"}},"type":"object","required":["birth_date","target_date","days_since_birth","cycles","critical_today","has_critical_day","composite_score","note"],"title":"BiorhythmSingleDayResponse"},"BirthInput":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"BirthInput","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"BirthNakshatraRef":{"properties":{"name":{"type":"string","title":"Name"},"index":{"type":"integer","title":"Index"}},"type":"object","required":["name","index"],"title":"BirthNakshatraRef"},"BusinessNameAnalysisResponse":{"properties":{"input":{"type":"string","title":"Input"},"input_type":{"type":"string","title":"Input Type"},"expression_number":{"type":"integer","title":"Expression Number"},"single_digit":{"type":"integer","title":"Single Digit"},"is_master":{"type":"boolean","title":"Is Master"},"theme":{"type":"string","title":"Theme"},"favourable_for":{"items":{"type":"string"},"type":"array","title":"Favourable For"},"caution":{"type":"string","title":"Caution"},"harmony_score":{"type":"integer","title":"Harmony Score"}},"type":"object","required":["input","input_type","expression_number","single_digit","is_master","theme","favourable_for","caution","harmony_score"],"title":"BusinessNameAnalysisResponse"},"BusinessNamePostRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name","description":"Business name to analyse"}},"type":"object","required":["name"],"title":"BusinessNamePostRequest"},"CalendarDay":{"properties":{"date":{"type":"string","title":"Date","description":"Date in YYYY-MM-DD format."},"tithi":{"$ref":"#/components/schemas/CalendarTithi","description":"Tithi for this day."},"vara":{"$ref":"#/components/schemas/CalendarVara","description":"Weekday for this day."},"nakshatra":{"$ref":"#/components/schemas/CalendarNakshatra","description":"Moon nakshatra for this day."},"yoga":{"$ref":"#/components/schemas/CalendarYoga","description":"Yoga for this day."},"karana":{"$ref":"#/components/schemas/CalendarKarana","description":"Karana for this day."},"rahu_kaal":{"$ref":"#/components/schemas/CalendarRahuKaal","description":"Rahu Kaal window for this day."}},"type":"object","required":["date","tithi","vara","nakshatra","yoga","karana","rahu_kaal"],"title":"CalendarDay"},"CalendarKarana":{"properties":{"name":{"type":"string","title":"Name","description":"Karana name."},"number":{"type":"integer","title":"Number","description":"Karana number."},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time","description":"Karana end time if available."}},"type":"object","required":["name","number"],"title":"CalendarKarana"},"CalendarNakshatra":{"properties":{"name":{"type":"string","title":"Name","description":"Nakshatra name."},"index":{"type":"integer","title":"Index","description":"Zero-based nakshatra index, 0 to 26."},"pada":{"type":"integer","title":"Pada","description":"Pada number, 1 to 4."},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time","description":"Nakshatra end time if available."}},"type":"object","required":["name","index","pada"],"title":"CalendarNakshatra"},"CalendarRahuKaal":{"properties":{"start":{"type":"string","title":"Start","description":"Rahu Kaal start time in HH:MM local time."},"end":{"type":"string","title":"End","description":"Rahu Kaal end time in HH:MM local time."}},"type":"object","required":["start","end"],"title":"CalendarRahuKaal"},"CalendarTithi":{"properties":{"name":{"type":"string","title":"Name","description":"Tithi name."},"number":{"type":"integer","title":"Number","description":"Tithi number, 1 to 30."},"paksha":{"type":"string","title":"Paksha","description":"Shukla or Krishna."},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time","description":"Tithi end time if available."}},"type":"object","required":["name","number","paksha"],"title":"CalendarTithi"},"CalendarVara":{"properties":{"name":{"type":"string","title":"Name","description":"Weekday name in Sanskrit."},"number":{"type":"integer","title":"Number","description":"Weekday number, 1 to 7."},"lord":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lord","description":"Planetary lord of the weekday."}},"type":"object","required":["name","number"],"title":"CalendarVara"},"CalendarYoga":{"properties":{"name":{"type":"string","title":"Name","description":"Yoga name."},"index":{"type":"integer","title":"Index","description":"Zero-based yoga index, 0 to 26."},"is_inauspicious":{"type":"boolean","title":"Is Inauspicious","description":"True if this yoga is inauspicious."},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time","description":"Yoga end time if available."}},"type":"object","required":["name","index","is_inauspicious"],"title":"CalendarYoga"},"CardOfDayResponse":{"properties":{"date":{"type":"string","title":"Date","description":"Date for this card in YYYY-MM-DD format"},"card":{"$ref":"#/components/schemas/TarotCardSchema"},"is_reversed":{"type":"boolean","title":"Is Reversed"},"active_meaning":{"type":"string","title":"Active Meaning"},"active_keywords":{"items":{"type":"string"},"type":"array","title":"Active Keywords"}},"type":"object","required":["date","card","is_reversed","active_meaning","active_keywords"],"title":"CardOfDayResponse"},"ChaldeanNumberBlock":{"properties":{"raw":{"type":"integer","title":"Raw"},"reduced":{"type":"integer","title":"Reduced"},"theme":{"type":"string","title":"Theme"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["raw","reduced","theme","keywords","interpretation"],"title":"ChaldeanNumberBlock"},"ChaldeanRequest":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name","description":"Person name (BirthInput `name`)"},"date":{"type":"string","format":"date","title":"Date","description":"Birth date YYYY-MM-DD (BirthInput `date`)"}},"type":"object","required":["name","date"],"title":"ChaldeanRequest"},"ChaldeanResponse":{"properties":{"system":{"type":"string","title":"System"},"full_name":{"type":"string","title":"Full Name"},"birth_date":{"type":"string","title":"Birth Date"},"name_number":{"$ref":"#/components/schemas/ChaldeanNumberBlock"},"birth_number":{"$ref":"#/components/schemas/ChaldeanNumberBlock"},"compound_number":{"$ref":"#/components/schemas/ChaldeanNumberBlock"}},"type":"object","required":["system","full_name","birth_date","name_number","birth_number","compound_number"],"title":"ChaldeanResponse"},"ChandrabalaDetail":{"properties":{"moon_house_from_natal":{"type":"integer","title":"Moon House From Natal"},"is_favorable":{"type":"boolean","title":"Is Favorable"},"favorable_houses":{"items":{"type":"integer"},"type":"array","title":"Favorable Houses"}},"type":"object","required":["moon_house_from_natal","is_favorable","favorable_houses"],"title":"ChandrabalaDetail"},"CharAntardasha":{"properties":{"rashi":{"type":"string","title":"Rashi"},"rashi_index":{"type":"integer","title":"Rashi Index"},"years":{"type":"integer","title":"Years"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"}},"type":"object","required":["rashi","rashi_index","years","start_date","end_date"],"title":"CharAntardasha"},"CharDashaRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"cycles":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Cycles","description":"Dasha cycles to compute (1-3)","default":1}},"type":"object","required":["date"],"title":"CharDashaRequest","description":"Jaimini Char Dasha — extends :class:`BirthInput` with ``cycles``.\n\nBirth fields: ``name``, ``date``, ``time``, ``latitude``, ``longitude``, ``timezone``\n(or ``location``), ``ayanamsa``. Additional: ``cycles`` (1–3).","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"CharDashaResponse":{"properties":{"atmakaraka":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Atmakaraka"},"start_rashi":{"type":"string","title":"Start Rashi"},"start_rashi_index":{"type":"integer","title":"Start Rashi Index"},"karakas":{"additionalProperties":{"type":"string"},"type":"object","title":"Karakas"},"current_mahadasha":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Mahadasha"},"current_antardasha":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Antardasha"},"periods":{"items":{"$ref":"#/components/schemas/CharMahadasha"},"type":"array","title":"Periods"}},"type":"object","required":["atmakaraka","start_rashi","start_rashi_index","karakas","current_mahadasha","current_antardasha","periods"],"title":"CharDashaResponse"},"CharMahadasha":{"properties":{"rashi":{"type":"string","title":"Rashi"},"rashi_index":{"type":"integer","title":"Rashi Index"},"years":{"type":"integer","title":"Years"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"antardashas":{"items":{"$ref":"#/components/schemas/CharAntardasha"},"type":"array","title":"Antardashas"}},"type":"object","required":["rashi","rashi_index","years","start_date","end_date","antardashas"],"title":"CharMahadasha"},"ChartRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"ChartRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"ChartResponse":{"properties":{"lagna_north":{"type":"string","title":"Lagna North","description":"North Indian Lagna chart SVG string"},"lagna_south":{"type":"string","title":"Lagna South","description":"South Indian Lagna chart SVG string"},"navamsa_north":{"type":"string","title":"Navamsa North","description":"North Indian Navamsa (D9) chart SVG string"},"navamsa_south":{"type":"string","title":"Navamsa South","description":"South Indian Navamsa (D9) chart SVG string"},"legend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legend","description":"Superscript legend explaining chart markers"}},"type":"object","required":["lagna_north","lagna_south","navamsa_north","navamsa_south"],"title":"ChartResponse"},"ChoghadiyaPeriod":{"properties":{"period":{"type":"integer","title":"Period","description":"Period number, 1 to 8."},"name":{"type":"string","title":"Name","description":"Choghadiya name, e.g. Amrit, Shubh, Kaal."},"type":{"type":"string","title":"Type","description":"Classification: highly auspicious, auspicious, or inauspicious."},"ruling_planet":{"type":"string","title":"Ruling Planet","description":"Planet ruling this Choghadiya period."},"suitable_for":{"type":"string","title":"Suitable For","description":"Activities suited to this period."},"start":{"type":"string","title":"Start","description":"Period start time in HH:MM local time."},"end":{"type":"string","title":"End","description":"Period end time in HH:MM local time."},"is_current":{"type":"boolean","title":"Is Current","description":"True if this period is currently active."}},"type":"object","required":["period","name","type","ruling_planet","suitable_for","start","end","is_current"],"title":"ChoghadiyaPeriod"},"ChoghadiyaResponse":{"properties":{"date":{"type":"string","title":"Date","description":"Date for which Choghadiya is calculated (YYYY-MM-DD)."},"sunrise":{"type":"string","title":"Sunrise","description":"Sunrise time in HH:MM local time."},"sunset":{"type":"string","title":"Sunset","description":"Sunset time in HH:MM local time."},"day_choghadiya":{"items":{"$ref":"#/components/schemas/ChoghadiyaPeriod"},"type":"array","title":"Day Choghadiya","description":"8 Choghadiya periods from sunrise to sunset."},"night_choghadiya":{"items":{"$ref":"#/components/schemas/ChoghadiyaPeriod"},"type":"array","title":"Night Choghadiya","description":"8 Choghadiya periods from sunset to next sunrise."}},"type":"object","required":["date","sunrise","sunset","day_choghadiya","night_choghadiya"],"title":"ChoghadiyaResponse"},"CompatibilityPersonInput":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name","description":"Name of the person in compatibility calculation","examples":["Alice Sharma"]},"date":{"type":"string","format":"date","title":"Date","description":"Birth date for compatibility calculation (YYYY-MM-DD)","examples":["1990-05-14"]}},"type":"object","required":["name","date"],"title":"CompatibilityPersonInput"},"CompatibilityRequest":{"properties":{"person1":{"$ref":"#/components/schemas/CompatibilityPersonInput","description":"First person profile for compatibility analysis"},"person2":{"$ref":"#/components/schemas/CompatibilityPersonInput","description":"Second person profile for compatibility analysis"}},"type":"object","required":["person1","person2"],"title":"CompatibilityRequest"},"CompositePlanetSchema":{"properties":{"name":{"type":"string","title":"Name"},"longitude":{"type":"number","title":"Longitude"},"sign":{"type":"string","title":"Sign"},"sign_index":{"type":"integer","title":"Sign Index"},"degree_in_sign":{"type":"number","title":"Degree In Sign"},"dignity":{"type":"string","title":"Dignity"},"dignity_score":{"type":"integer","title":"Dignity Score"}},"type":"object","required":["name","longitude","sign","sign_index","degree_in_sign","dignity","dignity_score"],"title":"CompositePlanetSchema"},"CompositeResponse":{"properties":{"planets":{"items":{"$ref":"#/components/schemas/CompositePlanetSchema"},"type":"array","title":"Planets"},"ascendant_longitude":{"type":"number","title":"Ascendant Longitude"},"ascendant_sign":{"type":"string","title":"Ascendant Sign"},"ascendant_sign_index":{"type":"integer","title":"Ascendant Sign Index"},"aspects":{"items":{"$ref":"#/components/schemas/SynastryAspectSchema"},"type":"array","title":"Aspects"}},"type":"object","required":["planets","ascendant_longitude","ascendant_sign","ascendant_sign_index","aspects"],"title":"CompositeResponse"},"ContextVariant":{"properties":{"context":{"type":"string","title":"Context","description":"The specific dream context or variant."},"meaning":{"type":"string","title":"Meaning","description":"The interpretation for this specific context."}},"type":"object","required":["context","meaning"],"title":"ContextVariant"},"CoreNumber":{"properties":{"number":{"anyOf":[{"type":"integer"},{"type":"string"}],"title":"Number","description":"The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)"},"reduced_number":{"type":"integer","title":"Reduced Number","description":"The final reduced number (1-9)"},"is_master_number":{"type":"boolean","title":"Is Master Number","description":"Whether this is a master number (11, 22, 33)","default":false},"is_karmic_debt":{"type":"boolean","title":"Is Karmic Debt","description":"Whether this has karmic debt","default":false},"karmic_debt_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Karmic Debt Number","description":"The karmic debt number if applicable"},"interpretation":{"type":"string","title":"Interpretation","description":"Detailed interpretation of the number"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords","description":"Key traits and characteristics"}},"type":"object","required":["number","reduced_number","interpretation"],"title":"CoreNumber","description":"Model for a single numerology number with interpretation."},"CrystalEntry":{"properties":{"slug":{"type":"string","title":"Slug","description":"URL-safe identifier, e.g. 'amethyst', 'blue-sapphire'."},"name":{"type":"string","title":"Name","description":"Display name of the crystal."},"colors":{"items":{"type":"string"},"type":"array","title":"Colors","description":"Primary colours of this crystal."},"hardness_mohs":{"type":"number","title":"Hardness Mohs","description":"Hardness on the Mohs scale (1-10)."},"chakras":{"items":{"type":"string"},"type":"array","title":"Chakras","description":"Associated chakras."},"element":{"type":"string","title":"Element","description":"Classical element: Earth, Water, Fire, Air, or All."},"zodiac_signs":{"items":{"type":"string"},"type":"array","title":"Zodiac Signs","description":"Associated Western zodiac signs."},"vedic_planet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vedic Planet","description":"Vedic planetary correspondence. Null if no classical Vedic text assigns this stone."},"vedic_correspondence":{"type":"string","title":"Vedic Correspondence","description":"'navaratna' (primary classical gem), 'uparatna' (substitute gem), or 'none_classical' (no Vedic text assigns this stone)."},"western_planet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Western Planet","description":"Western metaphysical planetary correspondence."},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords","description":"Primary energy keywords."},"healing_physical":{"type":"string","title":"Healing Physical","description":"Physical healing properties."},"healing_emotional":{"type":"string","title":"Healing Emotional","description":"Emotional healing properties."},"healing_spiritual":{"type":"string","title":"Healing Spiritual","description":"Spiritual healing properties."},"description":{"type":"string","title":"Description","description":"Overview description."},"origins":{"items":{"type":"string"},"type":"array","title":"Origins","description":"Primary geographic origins."},"affirmation":{"type":"string","title":"Affirmation","description":"Affirmation for working with this crystal."},"caution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caution","description":"Important safety or usage cautions. Null if none."}},"type":"object","required":["slug","name","colors","hardness_mohs","chakras","element","zodiac_signs","vedic_correspondence","keywords","healing_physical","healing_emotional","healing_spiritual","description","origins","affirmation"],"title":"CrystalEntry"},"CrystalListResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total number of crystals in the database."},"crystals":{"items":{"$ref":"#/components/schemas/CrystalEntry"},"type":"array","title":"Crystals","description":"All crystals sorted alphabetically."}},"type":"object","required":["total","crystals"],"title":"CrystalListResponse"},"CrystalRecommendRequest":{"properties":{"zodiac_sign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zodiac Sign","description":"Western zodiac sign to filter by. Example: 'Taurus', 'Scorpio'.","examples":["Taurus"]},"chakra":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chakra","description":"Chakra to filter by. One of: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.","examples":["Heart"]},"intention":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intention","description":"Intention keyword to match. Example: 'protection', 'love', 'abundance'.","examples":["abundance"]},"limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","description":"Maximum number of recommendations to return.","default":5}},"type":"object","title":"CrystalRecommendRequest"},"CrystalRecommendResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Number of crystals returned."},"filters_applied":{"additionalProperties":true,"type":"object","title":"Filters Applied","description":"The filters used for this recommendation."},"crystals":{"items":{"$ref":"#/components/schemas/CrystalEntry"},"type":"array","title":"Crystals","description":"Recommended crystals sorted by match strength."}},"type":"object","required":["total","filters_applied","crystals"],"title":"CrystalRecommendResponse"},"DailyScore":{"properties":{"score":{"type":"integer","title":"Score"},"max_score":{"type":"integer","title":"Max Score"},"label":{"type":"string","title":"Label"}},"type":"object","required":["score","max_score","label"],"title":"DailyScore"},"DailyTransitResponse":{"properties":{"date":{"type":"string","title":"Date"},"transit_planets":{"items":{"$ref":"#/components/schemas/TransitPlanetRowSchema"},"type":"array","title":"Transit Planets"},"aspects":{"items":{"$ref":"#/components/schemas/TransitAspectSchema"},"type":"array","title":"Aspects"},"total_aspects":{"type":"integer","title":"Total Aspects"}},"type":"object","required":["date","transit_planets","aspects","total_aspects"],"title":"DailyTransitResponse"},"DashaEndpointResponse":{"properties":{"periods":{"items":{"$ref":"#/components/schemas/DashaPeriod"},"type":"array","title":"Periods","description":"Calculated Vimshottari dasha hierarchy","examples":[[]]},"interpretation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Interpretation","description":"Structured dasha interpretation summary","examples":[{}]},"birth_time_provided":{"type":"boolean","title":"Birth Time Provided","description":"Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.","default":true}},"type":"object","required":["periods"],"title":"DashaEndpointResponse"},"DashaPeriod":{"properties":{"planet":{"type":"string","title":"Planet","description":"Dasha lord for this period","examples":["Moon"]},"start_jd":{"type":"number","title":"Start Jd","description":"Julian day at period start","examples":[2451545.0]},"end_jd":{"type":"number","title":"End Jd","description":"Julian day at period end","examples":[2455566.5]},"start_date":{"type":"string","title":"Start Date","description":"ISO-like UTC date string for period start","examples":["2000-01-01"]},"end_date":{"type":"string","title":"End Date","description":"ISO-like UTC date string for period end","examples":["2010-12-31"]},"sub":{"anyOf":[{"items":{"$ref":"#/components/schemas/DashaPeriod"},"type":"array"},{"type":"null"}],"title":"Sub","description":"Nested sub-periods for deeper hierarchy levels","examples":[[]]},"modern_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modern Summary","description":"Optional modern interpretation summary for this period","examples":["A reflective period emphasizing emotional maturation."]}},"type":"object","required":["planet","start_jd","end_jd","start_date","end_date"],"title":"DashaPeriod"},"DashaRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"levels":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Levels","description":"Depth of dasha hierarchy to compute (1 to 5)","default":2,"examples":[2]}},"type":"object","required":["date"],"title":"DashaRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"DashaTransitsRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"target_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Date","description":"YYYY-MM-DD. Defaults to today."},"target_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Time","description":"HH:MM. Defaults to noon.","default":"12:00"},"target_timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Timezone","description":"Timezone for target date.","default":"Asia/Kolkata"}},"type":"object","required":["date"],"title":"DashaTransitsRequest","description":"Dasha–transit correlation — extends :class:`BirthInput`.\n\nBirth fields: ``name``, ``date``, ``time``, ``location`` or ``latitude``/``longitude``/\n``timezone``, ``ayanamsa``. Optional analysis instant: ``target_date``, ``target_time``,\n``target_timezone``.","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"DashaTransitsResponse":{"properties":{"target_date":{"type":"string","title":"Target Date"},"active_dasha":{"additionalProperties":true,"type":"object","title":"Active Dasha"},"transit_positions":{"additionalProperties":true,"type":"object","title":"Transit Positions"},"correlations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Correlations"},"periods_of_significance":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Periods Of Significance"}},"type":"object","required":["target_date","active_dasha","transit_positions","correlations","periods_of_significance"],"title":"DashaTransitsResponse"},"DashakootDoshas":{"properties":{"nadi_dosha":{"type":"boolean","title":"Nadi Dosha"},"nadi_cancelled":{"type":"boolean","title":"Nadi Cancelled"},"bhakoot_dosha":{"type":"boolean","title":"Bhakoot Dosha"},"bhakoot_cancelled":{"type":"boolean","title":"Bhakoot Cancelled"},"rajju_dosha":{"type":"boolean","title":"Rajju Dosha"},"rajju_group_boy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rajju Group Boy"},"rajju_group_girl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rajju Group Girl"},"vedha_dosha":{"type":"boolean","title":"Vedha Dosha"},"vedha_pair":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vedha Pair"}},"type":"object","required":["nadi_dosha","nadi_cancelled","bhakoot_dosha","bhakoot_cancelled","rajju_dosha","rajju_group_boy","rajju_group_girl","vedha_dosha","vedha_pair"],"title":"DashakootDoshas"},"DashakootRequest":{"properties":{"person1":{"$ref":"#/components/schemas/BirthInput","description":"Groom (boy) birth details. In classical Vedic matchmaking, person1 is always the groom. Tara and Stree Deergha are computed from person2 (bride) nakshatra to person1 (groom)."},"person2":{"$ref":"#/components/schemas/BirthInput","description":"Bride (girl) birth details. In classical Vedic matchmaking, person2 is always the bride. Tara and Stree Deergha are computed from person2 (bride) nakshatra to person1 (groom)."}},"type":"object","required":["person1","person2"],"title":"DashakootRequest"},"DashakootResponse":{"properties":{"total_score":{"type":"number","title":"Total Score"},"max_score":{"type":"number","title":"Max Score"},"percentage":{"type":"number","title":"Percentage"},"compatibility_level":{"type":"string","title":"Compatibility Level"},"breakdown":{"additionalProperties":{"type":"number"},"type":"object","title":"Breakdown"},"max_per_koota":{"additionalProperties":{"type":"number"},"type":"object","title":"Max Per Koota"},"doshas":{"$ref":"#/components/schemas/DashakootDoshas"},"supplementary":{"additionalProperties":true,"type":"object","title":"Supplementary"}},"type":"object","required":["total_score","max_score","percentage","compatibility_level","breakdown","max_per_koota","doshas","supplementary"],"title":"DashakootResponse"},"DigitNumberAnalysisResponse":{"properties":{"input":{"type":"string","title":"Input"},"input_type":{"type":"string","title":"Input Type"},"total":{"type":"integer","title":"Total"},"single_digit":{"type":"integer","title":"Single Digit"},"is_master":{"type":"boolean","title":"Is Master"},"theme":{"type":"string","title":"Theme"},"favourable_for":{"items":{"type":"string"},"type":"array","title":"Favourable For"},"caution":{"type":"string","title":"Caution"},"harmony_score":{"type":"integer","title":"Harmony Score"}},"type":"object","required":["input","input_type","total","single_digit","is_master","theme","favourable_for","caution","harmony_score"],"title":"DigitNumberAnalysisResponse","description":"Mobile or vehicle number analysis (digit-sum reduction)."},"DivisionalRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"chart_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chart Type","description":"Return only this divisional chart (e.g. D9). Omit for all standard charts."}},"type":"object","required":["date"],"title":"DivisionalRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"DivisionalResponse":{"properties":{"D1":{"additionalProperties":true,"type":"object","title":"D1","description":"Rashi — the natal chart itself"},"D2":{"additionalProperties":true,"type":"object","title":"D2","description":"Hora — wealth and financial potential"},"D3":{"additionalProperties":true,"type":"object","title":"D3","description":"Drekkana — siblings and courage"},"D4":{"additionalProperties":true,"type":"object","title":"D4","description":"Chaturthamsha — property and fixed assets"},"D7":{"additionalProperties":true,"type":"object","title":"D7","description":"Saptamsha — children and creative output"},"D9":{"additionalProperties":true,"type":"object","title":"D9","description":"Navamsha — spouse, dharma, and deeper soul purpose. A primary divisional chart."},"D10":{"additionalProperties":true,"type":"object","title":"D10","description":"Dashamsha — career and professional life"},"D12":{"additionalProperties":true,"type":"object","title":"D12","description":"Dwadashamsha — parents and ancestral karma"},"D16":{"additionalProperties":true,"type":"object","title":"D16","description":"Shodashamsha — vehicles and comforts"},"D20":{"additionalProperties":true,"type":"object","title":"D20","description":"Vimshamsha — spiritual life and upasana"},"D24":{"additionalProperties":true,"type":"object","title":"D24","description":"Chaturvimshamsha — education and learning"},"D27":{"additionalProperties":true,"type":"object","title":"D27","description":"Bhamsha — strength and physical vitality"},"D30":{"additionalProperties":true,"type":"object","title":"D30","description":"Trimshamsha — misfortunes and evils"},"D40":{"additionalProperties":true,"type":"object","title":"D40","description":"Khavedamsha — auspicious and inauspicious effects"},"D45":{"additionalProperties":true,"type":"object","title":"D45","description":"Akshavedamsha — all matters of life"},"D60":{"additionalProperties":true,"type":"object","title":"D60","description":"Shashtyamsha — all matters, most subtle divisional chart"},"birth_time_provided":{"type":"boolean","title":"Birth Time Provided","description":"Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.","default":true}},"type":"object","required":["D1","D2","D3","D4","D7","D9","D10","D12","D16","D20","D24","D27","D30","D40","D45","D60"],"title":"DivisionalResponse"},"DoshaEndpointResponse":{"properties":{"doshas":{"additionalProperties":{"$ref":"#/components/schemas/DoshaResult"},"type":"object","title":"Doshas"},"birth_time_provided":{"type":"boolean","title":"Birth Time Provided","description":"Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.","default":true}},"type":"object","required":["doshas"],"title":"DoshaEndpointResponse"},"DoshaRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"DoshaRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"DoshaResult":{"properties":{"present":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Present","description":"Whether this dosha is present in the chart","examples":[true]},"types":{"items":{"type":"string"},"type":"array","title":"Types","description":"Dosha subtypes or tags detected for this dosha","examples":[["partial","strong"]]},"details":{"additionalProperties":true,"type":"object","title":"Details","description":"Structured diagnostic details for dosha evaluation","examples":[{"house":7,"notes":"Mars influence"}]},"interpretation_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Interpretation Summary","description":"Modern interpretation summary for present dosha","examples":["Relationship friction can rise without conscious communication."]},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"Keywords associated with this dosha interpretation","examples":[["marriage","conflict"]]},"remedies":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Remedies","description":"Traditional remedies associated with this dosha","examples":[["Worship Hanuman on Tuesdays"]]}},"type":"object","title":"DoshaResult"},"DrawRequest":{"properties":{"count":{"type":"integer","maximum":78.0,"minimum":1.0,"title":"Count","description":"Number of cards to draw (1-78). Default: 1.","default":1,"examples":[3]},"allow_reversed":{"type":"boolean","title":"Allow Reversed","description":"If true, each card has a 50% chance of appearing reversed.","default":false}},"type":"object","title":"DrawRequest"},"DrawResponse":{"properties":{"cards":{"items":{"$ref":"#/components/schemas/DrawnCardSchema"},"type":"array","title":"Cards"},"count":{"type":"integer","title":"Count"},"allow_reversed":{"type":"boolean","title":"Allow Reversed"}},"type":"object","required":["cards","count","allow_reversed"],"title":"DrawResponse"},"DrawnCardSchema":{"properties":{"card":{"$ref":"#/components/schemas/TarotCardSchema"},"is_reversed":{"type":"boolean","title":"Is Reversed","description":"True if the card was drawn in reversed orientation"},"position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Position","description":"Spread position name e.g. 'past', 'present', 'outcome'"},"position_meaning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Position Meaning","description":"What this spread position represents"},"active_meaning":{"type":"string","title":"Active Meaning","description":"The meaning to apply — upright_meaning when is_reversed=False, reversed_meaning when True"},"active_keywords":{"items":{"type":"string"},"type":"array","title":"Active Keywords","description":"Active keywords for this orientation"}},"type":"object","required":["card","is_reversed","active_meaning","active_keywords"],"title":"DrawnCardSchema"},"DreamSymbol":{"properties":{"slug":{"type":"string","title":"Slug","description":"URL-safe identifier."},"name":{"type":"string","title":"Name","description":"Display name of the symbol."},"category":{"type":"string","title":"Category","description":"Symbol category: animals, nature, people, places, objects, actions, body, or abstract."},"jungian_meaning":{"type":"string","title":"Jungian Meaning","description":"Jungian/Western psychological interpretation."},"jungian_archetype":{"type":"string","title":"Jungian Archetype","description":"Primary Jungian archetype activated by this symbol."},"vedic_meaning":{"type":"string","title":"Vedic Meaning","description":"Classical Vedic dream tradition interpretation."},"vedic_auspicious":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Vedic Auspicious","description":"True if auspicious (Shubha), False if inauspicious (Ashubha), null if mixed/context-dependent."},"traditions_agree":{"type":"string","title":"Traditions Agree","description":"Whether Jungian and Vedic traditions agree: 'agree', 'conflict', or 'partial'."},"emotional_tone":{"type":"string","title":"Emotional Tone","description":"Primary emotional register: anxiety, transformation, auspicious, warning, grief, power, healing, clarity, confusion, or neutral."},"themes":{"items":{"type":"string"},"type":"array","title":"Themes","description":"Thematic keywords used for AI synthesis and search."},"context_variants":{"items":{"$ref":"#/components/schemas/ContextVariant"},"type":"array","title":"Context Variants","description":"Alternative readings depending on dream context."},"related_symbols":{"items":{"type":"string"},"type":"array","title":"Related Symbols","description":"Slugs of related dream symbols."}},"type":"object","required":["slug","name","category","jungian_meaning","jungian_archetype","vedic_meaning","traditions_agree","emotional_tone","themes","context_variants","related_symbols"],"title":"DreamSymbol"},"DreamSymbolListResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total number of symbols returned."},"category_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Filter","description":"Category filter applied, if any."},"symbols":{"items":{"$ref":"#/components/schemas/DreamSymbol"},"type":"array","title":"Symbols","description":"Dream symbols sorted alphabetically."}},"type":"object","required":["total","symbols"],"title":"DreamSymbolListResponse"},"ErrorCode":{"type":"string","enum":["authentication_failed","api_key_missing","api_key_not_found","api_key_revoked","api_key_invalid","magic_link_not_found","magic_link_already_used","magic_link_expired","session_not_found","session_revoked","session_expired","exchange_code_not_found","exchange_code_already_used","ip_rate_limit_exceeded","burst_limit_exceeded","monthly_usage_limit_exceeded","magic_link_ip_limit_exceeded","magic_link_email_limit_exceeded","exchange_code_attempt_limit_exceeded","validation_error","invalid_email","invalid_key_name","invalid_request_body","date_out_of_supported_range","polar_latitude_unsupported","sun_calculation_failed","solar_day_out_of_range","ephemeris_unavailable","location_required","geocode_query_too_short","plan_not_found","account_not_found","key_not_found","subscription_not_found","city_not_found","interpretation_not_found","resource_not_found","endpoint_restricted","ownership_denied","insufficient_tier","payment_verification_failed","order_creation_failed","already_on_plan","max_keys_exceeded","subscription_expired","payment_provider_unavailable","payment_request_invalid","payload_too_large","email_delivery_failed","geocode_unavailable","dependency_unavailable","internal_error"],"title":"ErrorCode"},"ErrorResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always false for error responses.","default":false,"examples":[false]},"error":{"$ref":"#/components/schemas/ErrorCode","description":"Machine-readable error code. Use this for programmatic error handling. See doc_url for the canonical docs page. The full set of codes is the ErrorCode enum in this schema.","examples":["validation_error"]},"message":{"type":"string","title":"Message","description":"Human-readable explanation of what went wrong and how to fix it. Safe to surface in customer-facing UIs.","examples":["Invalid house_system 'foo'. Valid options: equal, koch, placidus, porphyry, whole_sign."]},"details":{"items":{},"type":"array","title":"Details","description":"Optional structured details. For validation errors, contains per-field error objects. Empty list when there are no structured details.","examples":[[{"loc":["body","date"],"msg":"Invalid date"}]]},"retry_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After","description":"Seconds to wait before retrying. Present on 429 (rate limit) and 503 (temporary outage) responses. Null when retry is not advised or applicable.","examples":[60]},"doc_url":{"type":"string","title":"Doc Url","description":"Canonical documentation URL for this error code. Contains causes, examples, and resolution steps.","examples":["https://docs.asterwise.com/reference/errors/validation_error/"]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Unique identifier for this request. Include when contacting support to enable rapid investigation.","examples":["req_01HXYZABCDEFGH"]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","description":"ISO 8601 timestamp of when the error occurred. UTC.","examples":["2026-05-19T12:34:56.789Z"]}},"type":"object","required":["error","message","doc_url"],"title":"ErrorResponse","description":"Standard error envelope returned by all Asterwise API endpoints.\n\nEvery error response follows this 8-field shape. The 'error' field\nis the machine-readable identifier (use it for programmatic handling).\nThe 'message' field is the human-readable explanation. The 'doc_url'\nfield links to the canonical documentation for the error code.\nInclude 'request_id' when contacting support."},"FestivalCalendarResponse":{"properties":{"year":{"type":"integer","title":"Year","description":"Calendar year for which festivals are computed."},"timezone":{"type":"string","title":"Timezone","description":"IANA timezone used for sunrise-based tithi calculations."},"total":{"type":"integer","title":"Total","description":"Total number of festivals found."},"festivals":{"items":{"$ref":"#/components/schemas/FestivalEntry"},"type":"array","title":"Festivals","description":"Festivals sorted chronologically by date."}},"type":"object","required":["year","timezone","total","festivals"],"title":"FestivalCalendarResponse"},"FestivalEntry":{"properties":{"name":{"type":"string","title":"Name","description":"Festival name."},"date":{"type":"string","title":"Date","description":"Festival date in YYYY-MM-DD format."},"type":{"type":"string","title":"Type","description":"Festival type: 'solar' (sankranti-based) or 'tithi' (lunar day-based)."},"description":{"type":"string","title":"Description","description":"Classical basis for the festival date (tithi or sankranti)."},"significance":{"type":"string","title":"Significance","description":"Cultural and religious significance."}},"type":"object","required":["name","date","type","description","significance"],"title":"FestivalEntry"},"GemstoneRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"GemstoneRequest","description":"Gemstone recommendations — same birth fields as :class:`BirthInput` (no ``top_n``).","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"GemstoneResponse":{"properties":{"primary":{"additionalProperties":true,"type":"object","title":"Primary"},"secondary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Secondary"},"yogakaraka_gem":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Yogakaraka Gem"},"fifth_lord_gem":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fifth Lord Gem"},"ninth_lord_gem":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ninth Lord Gem"},"atmakaraka_gem":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Atmakaraka Gem"},"contraindicated":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Contraindicated"},"note":{"type":"string","title":"Note"}},"type":"object","required":["primary","secondary","contraindicated","note"],"title":"GemstoneResponse"},"GeocodeResponse":{"properties":{"query":{"type":"string","title":"Query","description":"The search query as received."},"count":{"type":"integer","title":"Count","description":"Number of results returned."},"ambiguous":{"type":"boolean","title":"Ambiguous","description":"True if multiple locations matched the query."},"results":{"items":{"$ref":"#/components/schemas/GeocodeResult"},"type":"array","title":"Results","description":"List of matching locations."},"tip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tip","description":"Disambiguation hint when ambiguous is True."}},"type":"object","required":["query","count","ambiguous","results"],"title":"GeocodeResponse"},"GeocodeResult":{"properties":{"label":{"type":"string","title":"Label","description":"Human-readable location label."},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City name."},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State","description":"State or region."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country name."},"latitude":{"type":"number","title":"Latitude","description":"Latitude in decimal degrees."},"longitude":{"type":"number","title":"Longitude","description":"Longitude in decimal degrees."},"timezone":{"type":"string","title":"Timezone","description":"IANA timezone identifier."},"place_id":{"type":"string","title":"Place Id","description":"Nominatim place ID."}},"type":"object","required":["label","latitude","longitude","timezone","place_id"],"title":"GeocodeResult"},"GhatChakraResponse":{"properties":{"janma_rasi":{"type":"string","title":"Janma Rasi"},"janma_rasi_index":{"type":"integer","title":"Janma Rasi Index"},"ghatak_parameters":{"$ref":"#/components/schemas/GhatakParameters"},"guidance":{"type":"string","title":"Guidance"},"avoidance_guidance":{"items":{"type":"string"},"type":"array","title":"Avoidance Guidance"}},"type":"object","required":["janma_rasi","janma_rasi_index","ghatak_parameters","guidance","avoidance_guidance"],"title":"GhatChakraResponse"},"GhatakMasa":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["name","description"],"title":"GhatakMasa"},"GhatakNakshatra":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["name","description"],"title":"GhatakNakshatra"},"GhatakParameters":{"properties":{"masa":{"$ref":"#/components/schemas/GhatakMasa"},"tithi":{"$ref":"#/components/schemas/GhatakTithi"},"vara":{"$ref":"#/components/schemas/GhatakVara"},"nakshatra":{"$ref":"#/components/schemas/GhatakNakshatra"}},"type":"object","required":["masa","tithi","vara","nakshatra"],"title":"GhatakParameters"},"GhatakTithi":{"properties":{"group":{"type":"string","title":"Group"},"tithi_numbers":{"items":{"type":"integer"},"type":"array","title":"Tithi Numbers"},"description":{"type":"string","title":"Description"}},"type":"object","required":["group","tithi_numbers","description"],"title":"GhatakTithi"},"GhatakVara":{"properties":{"day":{"type":"string","title":"Day"},"description":{"type":"string","title":"Description"}},"type":"object","required":["day","description"],"title":"GhatakVara"},"GocharNatalRef":{"properties":{"moon_sign":{"type":"string","title":"Moon Sign"},"moon_sign_index":{"type":"integer","title":"Moon Sign Index"},"ascendant_sign":{"type":"string","title":"Ascendant Sign"},"ascendant_sign_index":{"type":"integer","title":"Ascendant Sign Index"}},"type":"object","required":["moon_sign","moon_sign_index","ascendant_sign","ascendant_sign_index"],"title":"GocharNatalRef"},"GocharRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"target_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Date","description":"YYYY-MM-DD. Defaults to today IST."},"target_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Time","description":"HH:MM. Defaults to noon.","default":"12:00"},"target_timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Timezone","description":"Timezone for target_date/time.","default":"Asia/Kolkata"}},"type":"object","required":["date"],"title":"GocharRequest","description":"Gochar — extends :class:`BirthInput` with optional transit instant fields.\n\nBirth fields: ``name``, ``date``, ``time``, ``location`` or coordinates, ``ayanamsa``.\nTransit evaluation: optional ``target_date``, ``target_time``, ``target_timezone``.","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"GocharResponse":{"properties":{"natal":{"$ref":"#/components/schemas/GocharNatalRef"},"target_date":{"type":"string","title":"Target Date"},"transits":{"items":{"$ref":"#/components/schemas/GocharTransitEntry"},"type":"array","title":"Transits"},"summary":{"$ref":"#/components/schemas/GocharSummary"}},"type":"object","required":["natal","target_date","transits","summary"],"title":"GocharResponse"},"GocharSummary":{"properties":{"favorable_count":{"type":"integer","title":"Favorable Count"},"unfavorable_count":{"type":"integer","title":"Unfavorable Count"},"vedha_blocked_count":{"type":"integer","title":"Vedha Blocked Count"},"overall_score":{"type":"integer","title":"Overall Score"},"sade_sati_active":{"type":"boolean","title":"Sade Sati Active"},"sade_sati_phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sade Sati Phase"},"sade_sati_interpretation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sade Sati Interpretation","description":"Phase-specific Sade Sati interpretation when active. Contains name, duration, saturn_position, and interpretation text for the current phase (rising, peak, or setting)."},"chandra_ashtama_active":{"type":"boolean","title":"Chandra Ashtama Active"}},"type":"object","required":["favorable_count","unfavorable_count","vedha_blocked_count","overall_score","sade_sati_active","sade_sati_phase","chandra_ashtama_active"],"title":"GocharSummary"},"GocharTransitEntry":{"properties":{"planet":{"type":"string","title":"Planet"},"transit_sign":{"type":"string","title":"Transit Sign"},"transit_sign_index":{"type":"integer","title":"Transit Sign Index"},"transit_degree":{"type":"number","title":"Transit Degree"},"is_retrograde":{"type":"boolean","title":"Is Retrograde"},"nakshatra":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nakshatra"},"nakshatra_pada":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Nakshatra Pada"},"house_from_moon":{"type":"integer","title":"House From Moon"},"house_from_lagna":{"type":"integer","title":"House From Lagna"},"is_favorable_from_moon":{"type":"boolean","title":"Is Favorable From Moon"},"is_favorable_from_lagna":{"type":"boolean","title":"Is Favorable From Lagna"},"vedha_active":{"type":"boolean","title":"Vedha Active"},"vedha_blocking_planet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vedha Blocking Planet"},"ashtakavarga_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ashtakavarga Score"},"interpretation":{"type":"string","title":"Interpretation"},"themes":{"items":{"type":"string"},"type":"array","title":"Themes"},"quality":{"type":"string","title":"Quality"}},"type":"object","required":["planet","transit_sign","transit_sign_index","transit_degree","is_retrograde","nakshatra","nakshatra_pada","house_from_moon","house_from_lagna","is_favorable_from_moon","is_favorable_from_lagna","vedha_active","vedha_blocking_planet","ashtakavarga_score","interpretation","themes","quality"],"title":"GocharTransitEntry"},"HarshaBalaEntry":{"properties":{"planet":{"type":"string","title":"Planet"},"harsha_bala":{"type":"integer","title":"Harsha Bala","description":"Harsha Bala score for this planet (0-20)."},"max_harsha_bala":{"type":"integer","title":"Max Harsha Bala","default":20},"varsha_house":{"type":"integer","title":"Varsha House","description":"Planet's house in the Varshaphal chart (from Varsha Ascendant)."},"rashi_index":{"type":"integer","title":"Rashi Index"},"rashi":{"type":"string","title":"Rashi"},"components":{"additionalProperties":true,"type":"object","title":"Components","description":"Breakdown of the 4 Harsha Bala components."},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["planet","harsha_bala","varsha_house","rashi_index","rashi","components","interpretation"],"title":"HarshaBalaEntry"},"HarshaBalaResponse":{"properties":{"target_year":{"type":"integer","title":"Target Year"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"solar_return_utc":{"type":"string","title":"Solar Return Utc"},"is_day_return":{"type":"boolean","title":"Is Day Return"},"varshaphal_ascendant_longitude":{"type":"number","title":"Varshaphal Ascendant Longitude"},"planets":{"items":{"$ref":"#/components/schemas/HarshaBalaEntry"},"type":"array","title":"Planets"}},"type":"object","required":["target_year","ayanamsa","solar_return_utc","is_day_return","varshaphal_ascendant_longitude","planets"],"title":"HarshaBalaResponse"},"HoraPeriod":{"properties":{"hora":{"type":"integer","title":"Hora","description":"Hora number, 1 to 24."},"ruling_planet":{"type":"string","title":"Ruling Planet","description":"Planet ruling this hora."},"start":{"type":"string","title":"Start","description":"Hora start time in HH:MM local time."},"end":{"type":"string","title":"End","description":"Hora end time in HH:MM local time."},"quality":{"type":"string","title":"Quality","description":"Activities suited to this planetary hora."},"is_current":{"type":"boolean","title":"Is Current","description":"True if this hora is currently active."}},"type":"object","required":["hora","ruling_planet","start","end","quality","is_current"],"title":"HoraPeriod"},"HoraResponse":{"properties":{"date":{"type":"string","title":"Date","description":"Date for which Hora is calculated (YYYY-MM-DD)."},"convention":{"type":"string","title":"Convention","description":"Hora division used. ``unequal_seasonal`` = 12 day + 12 night parts from real sunrise/sunset (panchanga / electional)."},"sunrise":{"type":"string","title":"Sunrise","description":"Sunrise time in HH:MM local time."},"sunset":{"type":"string","title":"Sunset","description":"Sunset time in HH:MM local time."},"next_sunrise":{"type":"string","title":"Next Sunrise","description":"Next day sunrise time in HH:MM local time."},"horas":{"items":{"$ref":"#/components/schemas/HoraPeriod"},"type":"array","title":"Horas","description":"24 planetary hours: 12 from sunrise to sunset, then 12 from sunset to next sunrise."}},"type":"object","required":["date","convention","sunrise","sunset","next_sunrise","horas"],"title":"HoraResponse"},"HoroscopeChapter":{"properties":{"chapter_number":{"type":"integer","title":"Chapter Number"},"start_date":{"type":"string","title":"Start Date","description":"Chapter start date (YYYY-MM-DD)"},"end_date":{"type":"string","title":"End Date","description":"Chapter end date (YYYY-MM-DD)"},"title":{"type":"string","title":"Title"},"theme":{"type":"string","title":"Theme"},"narrative":{"type":"string","title":"Narrative"}},"type":"object","required":["chapter_number","start_date","end_date","title","theme","narrative"],"title":"HoroscopeChapter"},"HoroscopeContent":{"properties":{"headline":{"type":"string","title":"Headline"},"narrative":{"type":"string","title":"Narrative"},"career":{"type":"string","title":"Career"},"money":{"type":"string","title":"Money"},"love":{"type":"string","title":"Love"},"body":{"type":"string","title":"Body"},"remedy":{"type":"string","title":"Remedy","description":"Programmatically injected Vedic remedy text","default":""},"do":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Do","description":"Daily: actions to take"},"avoid":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Avoid","description":"Daily: actions to avoid"},"open_loop":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Open Loop","description":"Daily: forward-looking watch item"},"peak_day":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Peak Day","description":"Weekly: strongest day"},"caution_day":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caution Day","description":"Weekly: day to approach carefully"},"weekly_mantra":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Weekly Mantra","description":"Weekly: shareable mantra line"},"phases":{"anyOf":[{"items":{"$ref":"#/components/schemas/HoroscopePhase"},"type":"array"},{"type":"null"}],"title":"Phases","description":"Monthly: phased breakdown"},"power_window":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Power Window","description":"Monthly: favorable date window"},"caution_window":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caution Window","description":"Monthly: cautious date window"},"closing_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Closing Message","description":"Monthly or yearly: shareable closing line"},"year_theme":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Year Theme","description":"Yearly: karmic theme for the year"},"chapters":{"anyOf":[{"items":{"$ref":"#/components/schemas/HoroscopeChapter"},"type":"array"},{"type":"null"}],"title":"Chapters","description":"Yearly: chapter breakdown"},"auspicious_months":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Auspicious Months","description":"Yearly: top auspicious months by name"},"landmark_dates":{"anyOf":[{"items":{"$ref":"#/components/schemas/HoroscopeLandmarkDate"},"type":"array"},{"type":"null"}],"title":"Landmark Dates","description":"Yearly: key dates with tone"}},"type":"object","required":["headline","narrative","career","money","love","body"],"title":"HoroscopeContent","description":"Stored horoscope prose; fields present depend on horizon (daily/weekly/monthly/yearly)."},"HoroscopeData":{"properties":{"content":{"$ref":"#/components/schemas/HoroscopeContent"},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At","description":"ISO timestamp when the horoscope was generated (UTC)"},"period_key":{"type":"string","title":"Period Key","description":"Period identifier (date, week, month, or year key)"},"horizon":{"type":"string","title":"Horizon","description":"Horizon: daily, weekly, monthly, or yearly"},"moon_sign":{"type":"string","title":"Moon Sign","description":"Normalised English Moon sign slug"}},"type":"object","required":["content","period_key","horizon","moon_sign"],"title":"HoroscopeData","description":"Payload returned by Vedic horoscope GET endpoints."},"HoroscopeLandmarkDate":{"properties":{"date":{"type":"string","title":"Date","description":"Landmark date (YYYY-MM-DD)"},"event":{"type":"string","title":"Event"},"tone":{"type":"string","title":"Tone","description":"Either favorable or challenging"}},"type":"object","required":["date","event","tone"],"title":"HoroscopeLandmarkDate"},"HoroscopePhase":{"properties":{"phase_number":{"type":"integer","title":"Phase Number"},"start_date":{"type":"string","title":"Start Date","description":"Phase start date (YYYY-MM-DD)"},"end_date":{"type":"string","title":"End Date","description":"Phase end date (YYYY-MM-DD)"},"title":{"type":"string","title":"Title"},"narrative":{"type":"string","title":"Narrative"}},"type":"object","required":["phase_number","start_date","end_date","title","narrative"],"title":"HoroscopePhase"},"HouseData":{"properties":{"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House","description":"House number in the natal chart","examples":[1]},"sign":{"type":"string","title":"Sign","description":"Sign occupying the house cusp","examples":["Virgo"]},"sign_num":{"type":"integer","title":"Sign Num","description":"Zero-based zodiac sign index for house cusp","examples":[5]},"degree":{"type":"number","title":"Degree","description":"House cusp degree within sign","examples":[12.44]}},"type":"object","required":["house","sign","sign_num","degree"],"title":"HouseData"},"IngressEvent":{"properties":{"planet":{"type":"string","title":"Planet","description":"Planet name, e.g. Sun, Mars, Rahu"},"from_sign":{"type":"integer","title":"From Sign","description":"Zero-based sign index the planet is leaving, 0 for Aries through 11 for Pisces"},"to_sign":{"type":"integer","title":"To Sign","description":"Zero-based sign index the planet is entering"},"jd":{"type":"number","title":"Jd","description":"Julian Day number of the ingress moment"},"date_iso":{"type":"string","title":"Date Iso","description":"Date of ingress in YYYY-MM-DD format"},"is_sankranti":{"type":"boolean","title":"Is Sankranti","description":"True for solar ingress (Sankranti); false for all other planets."},"retrograde_ingress":{"type":"boolean","title":"Retrograde Ingress","description":"True when the planet is retrograde (speed < 0) at the ingress moment."}},"type":"object","required":["planet","from_sign","to_sign","jd","date_iso","is_sankranti","retrograde_ingress"],"title":"IngressEvent"},"IshtaDevtaRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"IshtaDevtaRequest","description":"Ishta Devta — extends :class:`BirthInput`.\n\nInherits: ``name``, ``date``, ``time``, ``location`` or coordinates, ``ayanamsa``.","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"IshtaDevtaResponse":{"properties":{"atmakaraka":{"type":"string","title":"Atmakaraka"},"karakamsha_lagna":{"type":"string","title":"Karakamsha Lagna"},"karakamsha_lagna_index":{"type":"integer","title":"Karakamsha Lagna Index"},"jivanmuktamsa_planet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jivanmuktamsa Planet"},"navamsa_lagna":{"type":"string","title":"Navamsa Lagna"},"navamsa_lagna_index":{"type":"integer","title":"Navamsa Lagna Index"},"twelfth_house_sign":{"type":"string","title":"Twelfth House Sign"},"twelfth_house_index":{"type":"integer","title":"Twelfth House Index"},"planets_in_12th":{"items":{"type":"string"},"type":"array","title":"Planets In 12Th"},"ishta_devta_planet":{"type":"string","title":"Ishta Devta Planet"},"deity":{"type":"string","title":"Deity"},"description":{"type":"string","title":"Description"},"method":{"type":"string","title":"Method"},"d9_positions":{"additionalProperties":true,"type":"object","title":"D9 Positions"}},"type":"object","required":["atmakaraka","karakamsha_lagna","karakamsha_lagna_index","navamsa_lagna","navamsa_lagna_index","twelfth_house_sign","twelfth_house_index","planets_in_12th","ishta_devta_planet","deity","description","method","d9_positions"],"title":"IshtaDevtaResponse"},"KPBirthRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"KPBirthRequest","description":"KP natal chart / significators — extends :class:`BirthInput`.\n\nFields: ``name``, ``date``, ``time``, ``location`` or ``latitude``/``longitude``/\n``timezone``, ``ayanamsa``.","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"KPChartResponse":{"properties":{"ayanamsa":{"type":"string","title":"Ayanamsa"},"lagna":{"$ref":"#/components/schemas/KPLagna"},"planets":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Planets"},"house_cusps":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"House Cusps"}},"type":"object","required":["ayanamsa","lagna","planets","house_cusps"],"title":"KPChartResponse"},"KPLagna":{"properties":{"rashi":{"type":"string","title":"Rashi"},"rashi_index":{"type":"integer","title":"Rashi Index"},"longitude":{"type":"number","title":"Longitude"},"nakshatra_lord":{"type":"string","title":"Nakshatra Lord"},"sub_lord":{"type":"string","title":"Sub Lord"}},"type":"object","required":["rashi","rashi_index","longitude","nakshatra_lord","sub_lord"],"title":"KPLagna"},"KPRulingPlanetBody":{"properties":{"longitude":{"type":"number","title":"Longitude"},"rashi":{"type":"string","title":"Rashi"},"sign_lord":{"type":"string","title":"Sign Lord"},"nakshatra_lord":{"type":"string","title":"Nakshatra Lord"},"sub_lord":{"type":"string","title":"Sub Lord"}},"type":"object","required":["longitude","rashi","sign_lord","nakshatra_lord","sub_lord"],"title":"KPRulingPlanetBody"},"KPRulingPlanetsRequest":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude in decimal degrees. North positive, south negative."},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude in decimal degrees. East positive, west negative."},"target_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Date","description":"YYYY-MM-DD. Defaults to today."},"target_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Time","description":"HH:MM","default":"12:00"},"target_timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Timezone","description":"IANA timezone","default":"Asia/Kolkata"}},"type":"object","required":["latitude","longitude"],"title":"KPRulingPlanetsRequest"},"KPRulingPlanetsResponse":{"properties":{"ayanamsa":{"type":"string","title":"Ayanamsa"},"target_utc":{"type":"string","title":"Target Utc"},"day_lord":{"type":"string","title":"Day Lord"},"moon":{"$ref":"#/components/schemas/KPRulingPlanetBody"},"ascendant":{"$ref":"#/components/schemas/KPRulingPlanetBody"},"ruling_planets":{"items":{"type":"string"},"type":"array","title":"Ruling Planets"}},"type":"object","required":["ayanamsa","target_utc","day_lord","moon","ascendant","ruling_planets"],"title":"KPRulingPlanetsResponse"},"KPSignificatorsResponse":{"properties":{"ayanamsa":{"type":"string","title":"Ayanamsa"},"significators":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Significators"},"planet_significators":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Planet Significators"}},"type":"object","required":["ayanamsa","significators","planet_significators"],"title":"KPSignificatorsResponse"},"KaalPeriod":{"properties":{"start":{"type":"string","title":"Start","description":"Period start time in HH:MM local time."},"end":{"type":"string","title":"End","description":"Period end time in HH:MM local time."},"duration_minutes":{"type":"integer","title":"Duration Minutes","description":"Duration of the period in minutes."},"is_active":{"type":"boolean","title":"Is Active","description":"True if this period is currently active."}},"type":"object","required":["start","end","duration_minutes","is_active"],"title":"KaalPeriod"},"KaranaData":{"properties":{"number":{"type":"integer","title":"Number","description":"Karana number, 1 to 60"},"name":{"type":"string","title":"Name","description":"Karana name"},"degrees_elapsed":{"type":"number","title":"Degrees Elapsed","description":"Degrees completed within the current karana"},"degrees_remaining":{"type":"number","title":"Degrees Remaining","description":"Degrees remaining until the next karana"},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time"}},"type":"object","required":["number","name","degrees_elapsed","degrees_remaining"],"title":"KaranaData"},"KarmicLessonsResponse":{"properties":{"karmic_lessons":{"items":{"type":"integer"},"type":"array","title":"Karmic Lessons","description":"Digit values 1-9 missing from the name. Empty list means no karmic lessons."},"has_karmic_lessons":{"type":"boolean","title":"Has Karmic Lessons"}},"type":"object","required":["karmic_lessons","has_karmic_lessons"],"title":"KarmicLessonsResponse"},"LalKitabChartResponse":{"properties":{"system":{"type":"string","title":"System"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"planets":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Planets"},"houses":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Houses"},"rin_analysis":{"additionalProperties":true,"type":"object","title":"Rin Analysis"}},"type":"object","required":["system","ayanamsa","planets","houses","rin_analysis"],"title":"LalKitabChartResponse"},"LalKitabPlanetRemedy":{"properties":{"planet":{"type":"string","title":"Planet"},"lk_house":{"type":"integer","title":"Lk House"},"rashi":{"type":"string","title":"Rashi"},"pucca_ghar":{"type":"boolean","title":"Pucca Ghar"},"kachcha_ghar":{"type":"boolean","title":"Kachcha Ghar"},"uchcha":{"type":"boolean","title":"Uchcha"},"neecha":{"type":"boolean","title":"Neecha"},"remedies":{"items":{"$ref":"#/components/schemas/LalKitabRemedyItem"},"type":"array","title":"Remedies"},"priority":{"type":"string","title":"Priority"}},"type":"object","required":["planet","lk_house","rashi","pucca_ghar","kachcha_ghar","uchcha","neecha","remedies","priority"],"title":"LalKitabPlanetRemedy"},"LalKitabRemediesResponse":{"properties":{"system":{"type":"string","title":"System"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"remedies":{"items":{"$ref":"#/components/schemas/LalKitabPlanetRemedy"},"type":"array","title":"Remedies"}},"type":"object","required":["system","ayanamsa","remedies"],"title":"LalKitabRemediesResponse"},"LalKitabRemedyItem":{"properties":{"type":{"type":"string","title":"Type"},"action":{"type":"string","title":"Action"}},"type":"object","required":["type","action"],"title":"LalKitabRemedyItem"},"LalKitabRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"LalKitabRequest","description":"Lal Kitab uses standard BirthInput.\nAyanamsa is always Lahiri — the ayanamsa field\nfrom BirthInput is ignored and overridden to lahiri.","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"LifePathResponse":{"properties":{"life_path_number":{"type":"integer","title":"Life Path Number","description":"Computed life path number","examples":[9]},"is_master_number":{"type":"boolean","title":"Is Master Number","description":"Whether life path is a master number","examples":[false]},"karmic_debt_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Karmic Debt Number","description":"Karmic debt number if present","examples":[null]},"interpretation":{"type":"string","title":"Interpretation","description":"Narrative interpretation for life path number","examples":["Humanitarian path with strong service orientation."]},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords","description":"Keywords associated with the life path number","examples":[["service","compassion","wisdom"]]}},"type":"object","required":["life_path_number","is_master_number","karmic_debt_number","interpretation","keywords"],"title":"LifePathResponse"},"LoShuNumberEntry":{"properties":{"count":{"type":"integer","title":"Count"},"plane":{"type":"string","title":"Plane"},"trait":{"type":"string","title":"Trait"},"status":{"type":"string","title":"Status"},"note":{"type":"string","title":"Note"}},"type":"object","required":["count","plane","trait","status","note"],"title":"LoShuNumberEntry"},"LoShuPlaneEntry":{"properties":{"numbers":{"items":{"type":"integer"},"type":"array","title":"Numbers"},"description":{"type":"string","title":"Description"},"complete":{"type":"boolean","title":"Complete"}},"type":"object","required":["numbers","description","complete"],"title":"LoShuPlaneEntry"},"LoShuRequest":{"properties":{"date":{"type":"string","format":"date","title":"Date","description":"Birth date YYYY-MM-DD (BirthInput `date`)"}},"type":"object","required":["date"],"title":"LoShuRequest"},"LoShuResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"grid":{"items":{"items":{"type":"integer"},"type":"array"},"type":"array","title":"Grid"},"present_numbers":{"items":{"type":"integer"},"type":"array","title":"Present Numbers"},"missing_numbers":{"items":{"type":"integer"},"type":"array","title":"Missing Numbers"},"repeated_numbers":{"items":{"type":"integer"},"type":"array","title":"Repeated Numbers"},"plane_analysis":{"additionalProperties":{"$ref":"#/components/schemas/LoShuPlaneEntry"},"type":"object","title":"Plane Analysis"},"number_analysis":{"additionalProperties":{"$ref":"#/components/schemas/LoShuNumberEntry"},"type":"object","title":"Number Analysis"}},"type":"object","required":["birth_date","grid","present_numbers","missing_numbers","repeated_numbers","plane_analysis","number_analysis"],"title":"LoShuResponse"},"LuckyNumbersApiResponse":{"properties":{"lucky_numbers":{"items":{"type":"integer"},"type":"array","title":"Lucky Numbers","description":"Generated lucky numbers"},"power_number":{"type":"integer","title":"Power Number","description":"Most powerful number for the person"},"date_specific":{"type":"boolean","title":"Date Specific","description":"Whether numbers are specific to a date","default":false},"interpretation":{"type":"string","title":"Interpretation","description":"How to use these numbers"}},"type":"object","required":["lucky_numbers","power_number","interpretation"],"title":"LuckyNumbersApiResponse"},"LunarReturnRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"after_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After Date","description":"Find the next lunar return after this date (YYYY-MM-DD). Defaults to today.","examples":["2026-05-01"]}},"type":"object","required":["date"],"title":"LunarReturnRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"MatchmakingRequest":{"properties":{"person1":{"$ref":"#/components/schemas/BirthInput","description":"First person's birth input profile. In classical Vedic matchmaking, person1 is the groom (boy).","examples":[{"ayanamsa":"lahiri","date":"1990-03-15","latitude":19.076,"longitude":72.8777,"name":"Aarav Kumar","time":"10:30","timezone":"Asia/Kolkata"}]},"person2":{"$ref":"#/components/schemas/BirthInput","description":"Second person's birth input profile. In classical Vedic matchmaking, person2 is the bride (girl).","examples":[{"ayanamsa":"lahiri","date":"1992-07-10","latitude":28.6139,"longitude":77.209,"name":"Priya Sharma","time":"08:15","timezone":"Asia/Kolkata"}]}},"type":"object","required":["person1","person2"],"title":"MatchmakingRequest","example":{"person1":{"ayanamsa":"lahiri","date":"1990-03-15","latitude":19.076,"longitude":72.8777,"name":"Aarav Kumar","time":"10:30","timezone":"Asia/Kolkata"},"person2":{"ayanamsa":"lahiri","date":"1992-07-10","latitude":28.6139,"longitude":77.209,"name":"Priya Sharma","time":"08:15","timezone":"Asia/Kolkata"}}},"MatchmakingResponse":{"properties":{"total_score":{"type":"number","title":"Total Score","description":"Overall Guna Milan score out of 36","examples":[27.5]},"breakdown":{"additionalProperties":{"type":"number"},"type":"object","title":"Breakdown","description":"Per-koota score breakdown","examples":[{"Nadi":8.0,"Varna":1.0}]},"compatibility_level":{"type":"string","title":"Compatibility Level","description":"Textual compatibility band derived from score","examples":["Very Good"]},"doshas":{"additionalProperties":true,"type":"object","title":"Doshas","description":"Detected compatibility doshas","examples":[{"nadi_dosha":false}]},"dosha_cancellations":{"additionalProperties":true,"type":"object","title":"Dosha Cancellations","description":"Traditional dosha cancellation flags","examples":[{"bhakoot_dosha_cancelled":true}]},"analysis":{"additionalProperties":true,"type":"object","title":"Analysis","description":"Additional high-level matchmaking analysis details","examples":[{"recommendation":"Good match, recommended for marriage"}]},"classical_vetoes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Classical Vetoes","description":"Classical veto checks (Vedha, Rajju) and veto status"},"mangal_compatibility":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Mangal Compatibility","description":"Mangal Dosha compatibility assessment between both partners"},"supplementary_checks":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Supplementary Checks","description":"Supplementary classical checks: Mahendra, Vedha, Rajju"},"compatibility_narrative":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Compatibility Narrative","description":"Narrative compatibility summary with strengths and concerns"},"birth_time_provided":{"type":"boolean","title":"Birth Time Provided","description":"Whether a precise birth time was provided for both persons. False when either person's birth time was not supplied or treated as unknown.","default":true,"examples":[true]}},"type":"object","required":["total_score","breakdown","compatibility_level","doshas","dosha_cancellations","analysis"],"title":"MatchmakingResponse"},"MaturityNumberRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name","examples":["Arjun Mehta"]},"date":{"type":"string","format":"date","title":"Date","description":"Birth date","examples":["1985-11-12"]}},"type":"object","required":["name","date"],"title":"MaturityNumberRequest"},"MaturityNumberResponse":{"properties":{"maturity_number":{"type":"integer","title":"Maturity Number"},"life_path_number":{"type":"integer","title":"Life Path Number"},"expression_number":{"type":"integer","title":"Expression Number"},"is_master_number":{"type":"boolean","title":"Is Master Number"}},"type":"object","required":["maturity_number","life_path_number","expression_number","is_master_number"],"title":"MaturityNumberResponse"},"MonthlyTransitResponse":{"properties":{"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"days":{"items":{"$ref":"#/components/schemas/DailyTransitResponse"},"type":"array","title":"Days"},"peak_aspects":{"items":{"$ref":"#/components/schemas/TransitAspectSchema"},"type":"array","title":"Peak Aspects"}},"type":"object","required":["start_date","end_date","days","peak_aspects"],"title":"MonthlyTransitResponse"},"MoonPhaseResponse":{"properties":{"date":{"type":"string","title":"Date","description":"Date in YYYY-MM-DD format"},"phase_name":{"type":"string","title":"Phase Name","description":"Current phase name","examples":["Full Moon"]},"phase_angle":{"type":"number","title":"Phase Angle","description":"Phase angle in degrees (0-360). 0=New Moon, 180=Full Moon"},"illumination_pct":{"type":"number","title":"Illumination Pct","description":"Percentage of Moon disk illuminated (0-100)","examples":[99.79]},"moon_age_days":{"type":"number","title":"Moon Age Days","description":"Days elapsed since last New Moon (0 to 29.53)"},"moon_longitude":{"type":"number","title":"Moon Longitude","description":"Tropical ecliptic longitude of Moon (0-360)"},"sun_longitude":{"type":"number","title":"Sun Longitude","description":"Tropical ecliptic longitude of Sun (0-360)"},"is_waxing":{"type":"boolean","title":"Is Waxing","description":"True if Moon is waxing (phase_angle < 180)"},"next_phase_name":{"type":"string","title":"Next Phase Name","description":"Name of the next major phase"},"next_phase_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Phase Date","description":"Estimated date of next major phase (YYYY-MM-DD)"}},"type":"object","required":["date","phase_name","phase_angle","illumination_pct","moon_age_days","moon_longitude","sun_longitude","is_waxing","next_phase_name"],"title":"MoonPhaseResponse"},"MuhurtaRequest":{"properties":{"event_type":{"type":"string","title":"Event Type","description":"Type of event. One of: marriage, travel, business, griha_pravesh, naming_ceremony"},"from_date":{"type":"string","title":"From Date","description":"Start date in YYYY-MM-DD format (inclusive)"},"to_date":{"type":"string","title":"To Date","description":"End date in YYYY-MM-DD format (inclusive). Maximum 30 days from from_date."},"latitude":{"type":"number","title":"Latitude","description":"Location latitude"},"longitude":{"type":"number","title":"Longitude","description":"Location longitude"},"timezone":{"type":"string","title":"Timezone","description":"IANA timezone string e.g. Asia/Kolkata"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"lahiri | raman | kp | tropical","default":"lahiri"},"top_n":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Top N","description":"Number of top windows to return (1-20)","default":5}},"type":"object","required":["event_type","from_date","to_date","latitude","longitude","timezone"],"title":"MuhurtaRequest"},"MuhurtaResponse":{"properties":{"event_type":{"type":"string","title":"Event Type"},"from_date":{"type":"string","title":"From Date"},"to_date":{"type":"string","title":"To Date"},"timezone":{"type":"string","title":"Timezone"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"total_windows_evaluated":{"type":"integer","title":"Total Windows Evaluated"},"top_windows":{"items":{"$ref":"#/components/schemas/MuhurtaWindow"},"type":"array","title":"Top Windows"}},"type":"object","required":["event_type","from_date","to_date","timezone","ayanamsa","total_windows_evaluated","top_windows"],"title":"MuhurtaResponse"},"MuhurtaWindow":{"properties":{"date":{"type":"string","title":"Date"},"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"score":{"type":"integer","title":"Score"},"choghadiya":{"type":"string","title":"Choghadiya"},"choghadiya_type":{"type":"string","title":"Choghadiya Type"},"yoga":{"type":"string","title":"Yoga"},"vara":{"type":"string","title":"Vara"},"vara_number":{"type":"integer","title":"Vara Number"},"tithi":{"type":"string","title":"Tithi"},"tithi_number":{"type":"integer","title":"Tithi Number"},"reason":{"type":"string","title":"Reason"},"is_rahu_kaal":{"type":"boolean","title":"Is Rahu Kaal","default":false},"is_abhijit":{"type":"boolean","title":"Is Abhijit","default":false},"is_amrita_siddhi":{"type":"boolean","title":"Is Amrita Siddhi","default":false},"is_sarvartha_siddhi":{"type":"boolean","title":"Is Sarvartha Siddhi","default":false}},"type":"object","required":["date","start","end","score","choghadiya","choghadiya_type","yoga","vara","vara_number","tithi","tithi_number","reason"],"title":"MuhurtaWindow"},"NakshatraActivities":{"properties":{"favorable":{"items":{"type":"string"},"type":"array","title":"Favorable"},"unfavorable":{"items":{"type":"string"},"type":"array","title":"Unfavorable"}},"type":"object","required":["favorable","unfavorable"],"title":"NakshatraActivities"},"NakshatraData":{"properties":{"index":{"type":"integer","title":"Index","description":"Zero-based nakshatra index, 0 to 26"},"name":{"type":"string","title":"Name","description":"Nakshatra name, e.g. Ashwini, Revati"},"pada":{"type":"integer","title":"Pada","description":"Pada number, 1 to 4"},"degrees_elapsed":{"type":"number","title":"Degrees Elapsed","description":"Degrees completed within the current nakshatra"},"degrees_remaining":{"type":"number","title":"Degrees Remaining","description":"Degrees remaining until the next nakshatra"},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time"}},"type":"object","required":["index","name","pada","degrees_elapsed","degrees_remaining"],"title":"NakshatraData"},"NakshatraPredictionRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"target_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Target Date","description":"Date for the prediction day; defaults to today"}},"type":"object","required":["date"],"title":"NakshatraPredictionRequest","description":"Nakshatra daily prediction — extends BirthInput with optional target_date.","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"NakshatraPredictionResponse":{"properties":{"target_date":{"type":"string","title":"Target Date"},"transit_moon":{"$ref":"#/components/schemas/TransitMoonRef"},"tarabala":{"$ref":"#/components/schemas/TarabalaDetail"},"chandrabala":{"$ref":"#/components/schemas/ChandrabalaDetail"},"daily_score":{"$ref":"#/components/schemas/DailyScore"},"transit_nakshatra_quality":{"$ref":"#/components/schemas/TransitNakshatraQuality"},"nakshatra_activities":{"$ref":"#/components/schemas/NakshatraActivities"},"birth_nakshatra":{"$ref":"#/components/schemas/BirthNakshatraRef"},"natal_moon_sign_index":{"type":"integer","title":"Natal Moon Sign Index"}},"type":"object","required":["target_date","transit_moon","tarabala","chandrabala","daily_score","transit_nakshatra_quality","nakshatra_activities","birth_nakshatra","natal_moon_sign_index"],"title":"NakshatraPredictionResponse"},"NakshatraProfileResponse":{"properties":{"name":{"type":"string","title":"Name"},"index":{"type":"integer","title":"Index"},"interpretation":{"additionalProperties":true,"type":"object","title":"Interpretation"},"activities":{"additionalProperties":true,"type":"object","title":"Activities"},"body_map":{"additionalProperties":true,"type":"object","title":"Body Map"}},"type":"object","required":["name","index","interpretation","activities","body_map"],"title":"NakshatraProfileResponse"},"NameCorrectionNameScore":{"properties":{"name":{"type":"string","title":"Name"},"expression":{"type":"integer","title":"Expression"},"soul_urge":{"type":"integer","title":"Soul Urge"},"personality":{"type":"integer","title":"Personality"},"is_master":{"type":"boolean","title":"Is Master"},"karmic_debt":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Karmic Debt"},"compatibility":{"type":"string","title":"Compatibility"},"harmony_score":{"type":"integer","title":"Harmony Score"}},"type":"object","required":["name","expression","soul_urge","personality","is_master","compatibility","harmony_score"],"title":"NameCorrectionNameScore"},"NameCorrectionRequest":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name","description":"Name to analyse (BirthInput `name`)"},"date":{"type":"string","format":"date","title":"Date","description":"Birth date YYYY-MM-DD (BirthInput `date`)"}},"type":"object","required":["name","date"],"title":"NameCorrectionRequest"},"NameCorrectionResponse":{"properties":{"full_name":{"type":"string","title":"Full Name"},"birth_date":{"type":"string","title":"Birth Date"},"life_path":{"type":"integer","title":"Life Path"},"current_name":{"$ref":"#/components/schemas/NameCorrectionNameScore"},"alternatives":{"items":{"$ref":"#/components/schemas/NameCorrectionNameScore"},"type":"array","title":"Alternatives"},"recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation"}},"type":"object","required":["full_name","birth_date","life_path","current_name","alternatives"],"title":"NameCorrectionResponse"},"NameNumberResponse":{"properties":{"number":{"type":"integer","title":"Number"},"is_master_number":{"type":"boolean","title":"Is Master Number"},"karmic_debt_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Karmic Debt Number"}},"type":"object","required":["number","is_master_number"],"title":"NameNumberResponse"},"NameOnlyRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name","description":"Full name (first and last)","examples":["Arjun Mehta"]}},"type":"object","required":["name"],"title":"NameOnlyRequest"},"NatalCrystalContext":{"properties":{"lagna_sign":{"type":"string","title":"Lagna Sign","description":"Ascendant sign (English)."},"lagna_lord":{"type":"string","title":"Lagna Lord","description":"Lord of the 1st house."},"fifth_sign":{"type":"string","title":"Fifth Sign","description":"5th house sign (English)."},"fifth_lord":{"type":"string","title":"Fifth Lord","description":"Lord of the 5th house (Panchamesh — Lucky Stone)."},"ninth_sign":{"type":"string","title":"Ninth Sign","description":"9th house sign (English)."},"ninth_lord":{"type":"string","title":"Ninth Lord","description":"Lord of the 9th house (Bhagyesh — Fortune Stone)."},"yogakaraka":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Yogakaraka","description":"Yogakaraka planet — lords both a non-1st Kendra and a non-1st Trikona. Null if none for this Lagna."},"contraindicated_lords":{"items":{"type":"string"},"type":"array","title":"Contraindicated Lords","description":"Planets that do not lord any Trikona house — their gems are contraindicated."},"ayanamsa":{"type":"string","title":"Ayanamsa","default":"lahiri"}},"type":"object","required":["lagna_sign","lagna_lord","fifth_sign","fifth_lord","ninth_sign","ninth_lord","contraindicated_lords"],"title":"NatalCrystalContext"},"NatalCrystalEntry":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"colors":{"items":{"type":"string"},"type":"array","title":"Colors"},"hardness_mohs":{"type":"number","title":"Hardness Mohs"},"chakras":{"items":{"type":"string"},"type":"array","title":"Chakras"},"element":{"type":"string","title":"Element"},"zodiac_signs":{"items":{"type":"string"},"type":"array","title":"Zodiac Signs"},"vedic_planet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vedic Planet"},"vedic_correspondence":{"type":"string","title":"Vedic Correspondence"},"western_planet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Western Planet"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"healing_physical":{"type":"string","title":"Healing Physical"},"healing_emotional":{"type":"string","title":"Healing Emotional"},"healing_spiritual":{"type":"string","title":"Healing Spiritual"},"description":{"type":"string","title":"Description"},"origins":{"items":{"type":"string"},"type":"array","title":"Origins"},"affirmation":{"type":"string","title":"Affirmation"},"caution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caution"},"match_score":{"type":"integer","title":"Match Score","description":"Gemstone match score based on house lordship."},"match_reasons":{"items":{"type":"string"},"type":"array","title":"Match Reasons","description":"Classical factors — which house lordship triggered this recommendation."},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","description":"Classical cautions for this specific chart context."}},"type":"object","required":["slug","name","colors","hardness_mohs","chakras","element","zodiac_signs","vedic_planet","vedic_correspondence","western_planet","keywords","healing_physical","healing_emotional","healing_spiritual","description","origins","affirmation","caution","match_score","match_reasons"],"title":"NatalCrystalEntry"},"NatalCrystalResponse":{"properties":{"natal_context":{"$ref":"#/components/schemas/NatalCrystalContext"},"total":{"type":"integer","title":"Total"},"crystals":{"items":{"$ref":"#/components/schemas/NatalCrystalEntry"},"type":"array","title":"Crystals"}},"type":"object","required":["natal_context","total","crystals"],"title":"NatalCrystalResponse"},"NatalRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"include_interpretation":{"type":"boolean","title":"Include Interpretation","description":"Whether to include planet-in-house interpretation layer","default":false,"examples":[false]}},"type":"object","required":["date"],"title":"NatalRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"NatalResponse":{"properties":{"planets":{"items":{"$ref":"#/components/schemas/PlanetPosition"},"type":"array","title":"Planets","description":"Computed planetary positions","examples":[[]]},"houses":{"items":{"$ref":"#/components/schemas/HouseData"},"type":"array","title":"Houses","description":"Computed house cusp placements","examples":[[]]},"ascendant":{"type":"number","title":"Ascendant","description":"Ascendant longitude in degrees","examples":[173.25]},"ascendant_sign":{"type":"string","title":"Ascendant Sign","description":"Ascendant sign name","examples":["Virgo"]},"ayanamsa_value":{"type":"number","title":"Ayanamsa Value","description":"Numerical ayanamsa value used in calculations","examples":[24.1]},"ayanamsa_used":{"type":"string","title":"Ayanamsa Used","description":"Ayanamsa mode used for the chart","examples":["lahiri"]},"birth_time_provided":{"type":"boolean","title":"Birth Time Provided","description":"Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.","default":true,"examples":[true]},"interpretation":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Interpretation","description":"Interpretation layer for planetary placements when requested","examples":[[]]},"ascendant_sign_interpretation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ascendant Sign Interpretation","description":"Interpretation details for ascendant sign when interpretation is requested","examples":[{}]},"moon_sign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Moon Sign","description":"Moon's rashi (Sanskrit sign name), same as the Moon entry in planets","examples":["Tula"]},"moon_nakshatra":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Moon Nakshatra","description":"Moon's nakshatra name, same as the Moon entry in planets","examples":["Swati"]},"moon_sign_interpretation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Moon Sign Interpretation","description":"Interpretation details for Moon sign when interpretation is requested","examples":[{}]},"moon_nakshatra_interpretation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Moon Nakshatra Interpretation","description":"Interpretation details for Moon nakshatra when interpretation is requested","examples":[{}]},"avakahada":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Avakahada","description":"Standard Avakahada Chakra details derived from Moon nakshatra and sign","examples":[{}]},"bhava_madhya":{"anyOf":[{"items":{"$ref":"#/components/schemas/BhavaMadhyaEntry"},"type":"array"},{"type":"null"}],"title":"Bhava Madhya","description":"House midpoint (Bhava Madhya) positions — ecliptic longitude with sign and house label."},"bhava_sandhi":{"anyOf":[{"items":{"$ref":"#/components/schemas/BhavaMadhyaEntry"},"type":"array"},{"type":"null"}],"title":"Bhava Sandhi","description":"House junction (Bhava Sandhi) positions — ecliptic longitude with sign and house label."},"graha_drishti":{"anyOf":[{"additionalProperties":{"additionalProperties":{"type":"integer"},"type":"object"},"type":"object"},{"type":"null"}],"title":"Graha Drishti","description":"Graha Drishti matrix (#143): each graha → map of aspected whole-sign house (1–12) to strength percent (25–100).","examples":[{"Sun":{"4":75,"7":100}}]},"rashi_drishti":{"anyOf":[{"items":{"$ref":"#/components/schemas/RashiDrishtiEntry"},"type":"array"},{"type":"null"}],"title":"Rashi Drishti","description":"Jaimini Rashi Drishti aspect pairs — each entry is one active sign-to-sign aspect."},"arudha_padas":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Arudha Padas","description":"Arudha A1–A12 (#141): each pada → sign_index and sign_name."},"upapada_lagna":{"anyOf":[{"$ref":"#/components/schemas/UpapadaLagna"},{"type":"null"}],"description":"Upapada Lagna (#142): Arudha of 12th house plus 2nd-from-Upapada analysis."}},"type":"object","required":["planets","houses","ascendant","ascendant_sign","ayanamsa_value","ayanamsa_used"],"title":"NatalResponse"},"NumberMeaningResponse":{"properties":{"number":{"type":"integer","title":"Number","description":"Number being interpreted","examples":[7]},"context":{"type":"string","enum":["general","life_path","expression","soul_urge","personality","birth_day","personal_year"],"title":"Context","description":"Numerology context for interpretation (`general` uses life_path meanings)","examples":["life_path"]},"interpretation":{"type":"string","title":"Interpretation","description":"Narrative meaning for the number in context","examples":["Seeker archetype focused on analysis and inner wisdom."]},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords","description":"Keywords for number-context meaning","examples":[["introspection","research","spirituality"]]},"theme":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Theme","description":"Optional theme label for this meaning","examples":["Inner development"]},"opportunities":{"items":{"type":"string"},"type":"array","title":"Opportunities","description":"Opportunity highlights for this meaning","examples":[["deep study","self-discovery"]]},"challenges":{"items":{"type":"string"},"type":"array","title":"Challenges","description":"Challenge highlights for this meaning","examples":[["isolation","overthinking"]]},"advice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advice","description":"Optional advice associated with this meaning","examples":["Balance reflection with practical action."]}},"type":"object","required":["number","context","interpretation"],"title":"NumberMeaningResponse"},"NumerologyProfileResponse":{"properties":{"life_path":{"$ref":"#/components/schemas/CoreNumber","description":"Life Path number - life purpose and journey"},"expression":{"$ref":"#/components/schemas/CoreNumber","description":"Expression/Destiny number - natural talents and abilities"},"soul_urge":{"$ref":"#/components/schemas/CoreNumber","description":"Soul Urge/Heart's Desire - inner motivations"},"personality":{"$ref":"#/components/schemas/CoreNumber","description":"Personality number - outer persona"},"birth_day":{"$ref":"#/components/schemas/CoreNumber","description":"Birth Day number - special talents"},"personal_year":{"anyOf":[{"$ref":"#/components/schemas/PersonalYear"},{"type":"null"}],"description":"Current or specified year insights"},"pinnacles":{"items":{"$ref":"#/components/schemas/PinnacleChallenge"},"type":"array","title":"Pinnacles","description":"Life pinnacle cycles"},"challenges":{"items":{"$ref":"#/components/schemas/PinnacleChallenge"},"type":"array","title":"Challenges","description":"Life challenge cycles"},"lucky_numbers":{"items":{"type":"integer"},"type":"array","title":"Lucky Numbers","description":"Personal lucky numbers"},"summary":{"type":"string","title":"Summary","description":"Overall numerology summary"},"key_traits":{"items":{"type":"string"},"type":"array","title":"Key Traits","description":"Key personality traits"}},"type":"object","required":["life_path","expression","soul_urge","personality","birth_day","summary"],"title":"NumerologyProfileResponse"},"NumerologyRequest":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name","description":"Person name used for numerology calculations (aligned with BirthInput `name`)","examples":["Arjun Mehta"]},"date":{"type":"string","format":"date","title":"Date","description":"Birth date (aligned with BirthInput `date`, YYYY-MM-DD)","examples":["1990-06-15"]},"current_year":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1900.0},{"type":"null"}],"title":"Current Year","description":"Optional target year override for annual calculations","examples":[2026]}},"type":"object","required":["name","date"],"title":"NumerologyRequest"},"PanchangaCalendarPostBody":{"properties":{"year":{"type":"integer","maximum":2100.0,"minimum":1900.0,"title":"Year"},"month":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Month"},"lat":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Lat"},"lon":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Lon"},"timezone":{"type":"string","title":"Timezone","description":"IANA timezone for the location","default":"Asia/Kolkata"},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","default":"lahiri"}},"type":"object","required":["year","month","lat","lon"],"title":"PanchangaCalendarPostBody"},"PanchangaCalendarResponse":{"properties":{"year":{"type":"integer","title":"Year","description":"Year of the calendar."},"month":{"type":"integer","title":"Month","description":"Month of the calendar, 1 to 12."},"timezone":{"type":"string","title":"Timezone","description":"IANA timezone used for calculations."},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Ayanamsa system used."},"days":{"items":{"$ref":"#/components/schemas/CalendarDay"},"type":"array","title":"Days","description":"Panchanga data for every day of the month."}},"type":"object","required":["year","month","timezone","ayanamsa","days"],"title":"PanchangaCalendarResponse"},"PanchangaExtRequest":{"properties":{"date":{"type":"string","title":"Date","description":"Date in YYYY-MM-DD format","examples":["2026-03-23"]},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name. Example: 'Mumbai'","examples":["Mumbai"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone string","examples":["Asia/Kolkata"]}},"type":"object","required":["date"],"title":"PanchangaExtRequest","description":"Base request schema for all panchanga extension endpoints."},"PanchangaRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Optional. Name is not used in panchanga calculations."},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"PanchangaRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"PanchangaResponse":{"properties":{"tithi":{"$ref":"#/components/schemas/TithiData","description":"Lunar day — the angular relationship between Sun and Moon"},"vara":{"$ref":"#/components/schemas/VaraData","description":"Weekday and its planetary lord"},"nakshatra":{"$ref":"#/components/schemas/NakshatraData","description":"Lunar mansion the Moon occupies at the given moment"},"yoga":{"$ref":"#/components/schemas/YogaData","description":"Luni-solar yoga — combined Sun and Moon longitude divided into 27 parts"},"karana":{"$ref":"#/components/schemas/KaranaData","description":"Half of a tithi — the smaller unit of lunar time"}},"type":"object","required":["tithi","vara","nakshatra","yoga","karana"],"title":"PanchangaResponse"},"PapasamyamRequest":{"properties":{"person1":{"$ref":"#/components/schemas/BirthInput","description":"Groom (boy) birth details. person1 is the groom."},"person2":{"$ref":"#/components/schemas/BirthInput","description":"Bride (girl) birth details. person2 is the bride."}},"type":"object","required":["person1","person2"],"title":"PapasamyamRequest"},"PapasamyamResponse":{"properties":{"person1":{"additionalProperties":true,"type":"object","title":"Person1"},"person2":{"additionalProperties":true,"type":"object","title":"Person2"},"score_difference":{"type":"number","title":"Score Difference"},"compatible":{"type":"boolean","title":"Compatible"},"compatibility_level":{"type":"string","title":"Compatibility Level"},"threshold":{"type":"number","title":"Threshold"}},"type":"object","required":["person1","person2","score_difference","compatible","compatibility_level","threshold"],"title":"PapasamyamResponse"},"PersonalAngelNumberRequest":{"properties":{"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format.","examples":["1994-03-31"]},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Optional name for personalisation.","examples":["Vinay Kant Bhalla"]}},"type":"object","required":["date"],"title":"PersonalAngelNumberRequest"},"PersonalAngelNumberResponse":{"properties":{"number":{"type":"string","title":"Number","description":"Angel number sequence, e.g. '111', '1111'."},"theme":{"type":"string","title":"Theme","description":"Core theme of this angel number."},"message":{"type":"string","title":"Message","description":"Primary message of this angel number."},"guidance":{"type":"string","title":"Guidance","description":"Actionable guidance for this number."},"areas":{"items":{"type":"string"},"type":"array","title":"Areas","description":"Life areas associated with this number."},"birth_date":{"type":"string","title":"Birth Date","description":"Birth date used for calculation (YYYY-MM-DD)."},"life_path":{"type":"integer","title":"Life Path","description":"Pythagorean Life Path number (1-9, or 11/22/33)."},"angel_number":{"type":"string","title":"Angel Number","description":"Angel number sequence derived from Life Path."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Name if provided."}},"type":"object","required":["number","theme","message","guidance","areas","birth_date","life_path","angel_number"],"title":"PersonalAngelNumberResponse"},"PersonalCycleRequest":{"properties":{"date":{"type":"string","format":"date","title":"Date","description":"Birth date","examples":["1985-11-12"]},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year","description":"Target year. Defaults to current year.","examples":[2026]},"month":{"anyOf":[{"type":"integer","maximum":12.0,"minimum":1.0},{"type":"null"}],"title":"Month","description":"Target month 1-12. Defaults to current month.","examples":[5]},"day":{"anyOf":[{"type":"integer","maximum":31.0,"minimum":1.0},{"type":"null"}],"title":"Day","description":"Target day 1-31. Required for personal day.","examples":[1]}},"type":"object","required":["date"],"title":"PersonalCycleRequest"},"PersonalCycleResponse":{"properties":{"personal_year":{"type":"integer","title":"Personal Year"},"personal_month":{"type":"integer","title":"Personal Month"},"personal_day":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Personal Day"},"target_year":{"type":"integer","title":"Target Year"},"target_month":{"type":"integer","title":"Target Month"},"target_day":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target Day"}},"type":"object","required":["personal_year","personal_month","target_year","target_month"],"title":"PersonalCycleResponse"},"PersonalYear":{"properties":{"year":{"type":"integer","title":"Year","description":"The year being calculated"},"personal_year_number":{"type":"integer","title":"Personal Year Number","description":"Personal year number (1-9)"},"theme":{"type":"string","title":"Theme","description":"Main theme for the year"},"interpretation":{"type":"string","title":"Interpretation","description":"Detailed interpretation"},"opportunities":{"items":{"type":"string"},"type":"array","title":"Opportunities","description":"Opportunities this year"},"challenges":{"items":{"type":"string"},"type":"array","title":"Challenges","description":"Challenges to watch for"},"advice":{"type":"string","title":"Advice","description":"Advice for the year"}},"type":"object","required":["year","personal_year_number","theme","interpretation","advice"],"title":"PersonalYear","description":"Model for personal year calculation."},"PersonalYearPostRequest":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name","description":"Person name (echoed for clients; not used in the calculation)"},"date":{"type":"string","format":"date","title":"Date","description":"Birth date (YYYY-MM-DD or ISO datetime string from clients)"},"year":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1900.0},{"type":"null"}],"title":"Year","description":"Calendar year to interpret; defaults to the current year"}},"type":"object","required":["name","date"],"title":"PersonalYearPostRequest","description":"MCP-friendly POST body for personal year (birth `date` + optional target `year`)."},"PersonalYearResponse":{"properties":{"year":{"type":"integer","title":"Year","description":"Calendar year evaluated","examples":[2026]},"personal_year_number":{"type":"integer","title":"Personal Year Number","description":"Computed personal year number","examples":[4]},"theme":{"type":"string","title":"Theme","description":"Primary theme for the personal year","examples":["Structure and discipline"]},"interpretation":{"type":"string","title":"Interpretation","description":"Narrative interpretation for this personal year","examples":["A practical year focused on building strong foundations."]},"opportunities":{"items":{"type":"string"},"type":"array","title":"Opportunities","description":"Potential opportunities in this year","examples":[["career consolidation","long-term planning"]]},"challenges":{"items":{"type":"string"},"type":"array","title":"Challenges","description":"Potential challenges in this year","examples":[["rigidity","slow progress"]]},"advice":{"type":"string","title":"Advice","description":"Practical recommendation for navigating the year","examples":["Stay consistent and prioritize sustainable habits."]}},"type":"object","required":["year","personal_year_number","theme","interpretation","opportunities","challenges","advice"],"title":"PersonalYearResponse"},"PinnacleChallenge":{"properties":{"number":{"type":"integer","title":"Number","description":"The pinnacle or challenge number"},"start_age":{"type":"integer","title":"Start Age","description":"Starting age for this cycle"},"end_age":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"End Age","description":"Ending age for this cycle (None for last cycle)"},"interpretation":{"type":"string","title":"Interpretation","description":"Interpretation for this cycle"},"focus_areas":{"items":{"type":"string"},"type":"array","title":"Focus Areas","description":"Key focus areas during this cycle"}},"type":"object","required":["number","start_age","interpretation"],"title":"PinnacleChallenge","description":"Model for pinnacle and challenge cycles."},"PitruDoshaResponse":{"properties":{"present":{"type":"boolean","title":"Present"},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity"},"severity_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity Note"},"combinations_triggered":{"items":{"type":"string"},"type":"array","title":"Combinations Triggered"},"combinations_count":{"type":"integer","title":"Combinations Count"},"sun_analysis":{"$ref":"#/components/schemas/PitruSunAnalysis"},"ninth_lord_analysis":{"$ref":"#/components/schemas/PitruNinthLordAnalysis"},"all_factors":{"items":{"type":"string"},"type":"array","title":"All Factors"},"cancellations":{"items":{"type":"string"},"type":"array","title":"Cancellations"},"interpretation":{"type":"string","title":"Interpretation"},"classical_symptoms":{"items":{"type":"string"},"type":"array","title":"Classical Symptoms"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"}},"type":"object","required":["present","combinations_triggered","combinations_count","sun_analysis","ninth_lord_analysis","all_factors","cancellations","interpretation","classical_symptoms","remedies"],"title":"PitruDoshaResponse"},"PitruNinthLordAnalysis":{"properties":{"planet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Planet"},"house":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"House"},"sign_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sign Index"},"debilitated":{"type":"boolean","title":"Debilitated"},"afflictions":{"items":{"type":"string"},"type":"array","title":"Afflictions"}},"type":"object","required":["debilitated","afflictions"],"title":"PitruNinthLordAnalysis"},"PitruSunAnalysis":{"properties":{"house":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"House"},"sign_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sign Index"},"debilitated":{"type":"boolean","title":"Debilitated"},"afflictions":{"items":{"type":"string"},"type":"array","title":"Afflictions"}},"type":"object","required":["debilitated","afflictions"],"title":"PitruSunAnalysis"},"PlanetNatureAllResponse":{"properties":{"planets":{"additionalProperties":{"$ref":"#/components/schemas/PlanetNatureEntry"},"type":"object","title":"Planets"}},"type":"object","required":["planets"],"title":"PlanetNatureAllResponse"},"PlanetNatureEntry":{"properties":{"tattva":{"type":"string","title":"Tattva"},"guna":{"type":"string","title":"Guna"},"gender":{"type":"string","title":"Gender"},"caste":{"type":"string","title":"Caste"},"nature":{"type":"string","title":"Nature"},"direction":{"type":"string","title":"Direction"},"color":{"type":"string","title":"Color"},"deity":{"type":"string","title":"Deity"},"day":{"type":"string","title":"Day"},"metal":{"type":"string","title":"Metal"},"body_part":{"type":"string","title":"Body Part"},"friends":{"items":{"type":"string"},"type":"array","title":"Friends"},"enemies":{"items":{"type":"string"},"type":"array","title":"Enemies"},"neutrals":{"items":{"type":"string"},"type":"array","title":"Neutrals"}},"type":"object","required":["tattva","guna","gender","caste","nature","direction","color","deity","day","metal","body_part","friends","enemies","neutrals"],"title":"PlanetNatureEntry"},"PlanetNatureSingleResponse":{"properties":{"tattva":{"type":"string","title":"Tattva"},"guna":{"type":"string","title":"Guna"},"gender":{"type":"string","title":"Gender"},"caste":{"type":"string","title":"Caste"},"nature":{"type":"string","title":"Nature"},"direction":{"type":"string","title":"Direction"},"color":{"type":"string","title":"Color"},"deity":{"type":"string","title":"Deity"},"day":{"type":"string","title":"Day"},"metal":{"type":"string","title":"Metal"},"body_part":{"type":"string","title":"Body Part"},"friends":{"items":{"type":"string"},"type":"array","title":"Friends"},"enemies":{"items":{"type":"string"},"type":"array","title":"Enemies"},"neutrals":{"items":{"type":"string"},"type":"array","title":"Neutrals"},"planet":{"type":"string","title":"Planet"}},"type":"object","required":["tattva","guna","gender","caste","nature","direction","color","deity","day","metal","body_part","friends","enemies","neutrals","planet"],"title":"PlanetNatureSingleResponse"},"PlanetPosition":{"properties":{"planet":{"type":"string","title":"Planet","description":"Planet name","examples":["Sun"]},"sign":{"type":"string","title":"Sign","description":"Zodiac sign name where the planet is placed","examples":["Virgo"]},"sign_num":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign Num","description":"Zero-based zodiac sign index","examples":[5]},"degree":{"type":"number","title":"Degree","description":"Sidereal longitude in degrees","examples":[170.12]},"nakshatra":{"type":"string","title":"Nakshatra","description":"Nakshatra name for planetary placement","examples":["Hasta"]},"nakshatra_pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Nakshatra Pada","description":"Nakshatra pada index","examples":[2]},"is_retrograde":{"type":"boolean","title":"Is Retrograde","description":"Whether the planet is retrograde","examples":[false]},"is_combust":{"type":"boolean","title":"Is Combust","description":"True if the planet is within its combustion orb of the Sun","default":false,"examples":[false]},"is_deep_combust":{"type":"boolean","title":"Is Deep Combust","description":"True if within 3° of the Sun (deep combustion / Gadha Moudhya)","default":false,"examples":[false]},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House","description":"Whole-sign (Rasi) house number where the planet is placed","examples":[1]},"rasi_house":{"anyOf":[{"type":"integer","maximum":12.0,"minimum":0.0},{"type":"null"}],"title":"Rasi House","description":"Same as `house` when present (explicit Rasi / whole-sign house)","examples":[1]},"bhava_chalit_house":{"anyOf":[{"type":"integer","maximum":12.0,"minimum":1.0},{"type":"null"}],"title":"Bhava Chalit House","description":"Bhava Chalit spatial house (1–12) when computed from Bhava Sandhi","examples":[3]},"house_system_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"House System Note","description":"Guidance on Rashi vs Bhava Chalit house placement when the two systems disagree for this planet."}},"type":"object","required":["planet","sign","sign_num","degree","nakshatra","nakshatra_pada","is_retrograde","house"],"title":"PlanetPosition"},"PlanetaryReturnRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"planet":{"type":"string","title":"Planet","description":"Planet name for the return chart","examples":["Venus"]},"after_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After Date","description":"Find the next return after this date (YYYY-MM-DD). Defaults to today.","examples":["2026-05-01"]}},"type":"object","required":["date","planet"],"title":"PlanetaryReturnRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"PortuthamRequest":{"properties":{"person1":{"$ref":"#/components/schemas/BirthInput","description":"Groom (boy) birth details. In classical Kerala Jyotish, person1 is the groom."},"person2":{"$ref":"#/components/schemas/BirthInput","description":"Bride (girl) birth details. In classical Kerala Jyotish, person2 is the bride."}},"type":"object","required":["person1","person2"],"title":"PortuthamRequest"},"PoruthamResponse":{"properties":{"total_passed":{"type":"integer","title":"Total Passed"},"total_poruthams":{"type":"integer","title":"Total Poruthams"},"compatibility_level":{"type":"string","title":"Compatibility Level"},"rajju_veto":{"type":"boolean","title":"Rajju Veto"},"vedha_veto":{"type":"boolean","title":"Vedha Veto"},"hard_veto":{"type":"boolean","title":"Hard Veto"},"breakdown":{"additionalProperties":true,"type":"object","title":"Breakdown"}},"type":"object","required":["total_passed","total_poruthams","compatibility_level","rajju_veto","vedha_veto","hard_veto","breakdown"],"title":"PoruthamResponse"},"PrashnaHouseAnalysis":{"properties":{"house":{"type":"integer","title":"House"},"rashi_index":{"type":"integer","title":"Rashi Index"},"rashi":{"type":"string","title":"Rashi"},"lord":{"type":"string","title":"Lord"},"lord_dignity":{"type":"string","title":"Lord Dignity"},"lord_house":{"type":"integer","title":"Lord House"},"lord_longitude":{"type":"number","title":"Lord Longitude"},"occupants":{"items":{"type":"string"},"type":"array","title":"Occupants"}},"type":"object","required":["house","rashi_index","rashi","lord","lord_dignity","lord_house","lord_longitude","occupants"],"title":"PrashnaHouseAnalysis"},"PrashnaHouseCusp":{"properties":{"rashi_index":{"type":"integer","title":"Rashi Index"},"rashi":{"type":"string","title":"Rashi"},"lord":{"type":"string","title":"Lord"},"longitude":{"type":"number","title":"Longitude"}},"type":"object","required":["rashi_index","rashi","lord","longitude"],"title":"PrashnaHouseCusp"},"PrashnaLagna":{"properties":{"rashi_index":{"type":"integer","title":"Rashi Index"},"rashi":{"type":"string","title":"Rashi"},"longitude":{"type":"number","title":"Longitude"},"lord":{"type":"string","title":"Lord"}},"type":"object","required":["rashi_index","rashi","longitude","lord"],"title":"PrashnaLagna"},"PrashnaMoon":{"properties":{"longitude":{"type":"number","title":"Longitude"},"rashi_index":{"type":"integer","title":"Rashi Index"},"rashi":{"type":"string","title":"Rashi"},"nakshatra":{"type":"string","title":"Nakshatra"},"phase":{"type":"string","title":"Phase"},"dignity":{"type":"string","title":"Dignity"},"void_of_course":{"type":"boolean","title":"Void Of Course"},"afflicted_moon":{"type":"boolean","title":"Afflicted Moon"},"applying_to_benefic":{"type":"boolean","title":"Applying To Benefic"}},"type":"object","required":["longitude","rashi_index","rashi","nakshatra","phase","dignity","void_of_course","afflicted_moon","applying_to_benefic"],"title":"PrashnaMoon"},"PrashnaPlanetSummary":{"properties":{"longitude":{"type":"number","title":"Longitude"},"rashi_index":{"type":"integer","title":"Rashi Index"},"rashi":{"type":"string","title":"Rashi"},"house":{"type":"integer","title":"House"},"is_retrograde":{"type":"boolean","title":"Is Retrograde"},"dignity":{"type":"string","title":"Dignity"}},"type":"object","required":["longitude","rashi_index","rashi","house","is_retrograde","dignity"],"title":"PrashnaPlanetSummary"},"PrashnaRequest":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Querent location latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Querent location longitude"},"question":{"type":"string","enum":["self","wealth","siblings","property","children","health","marriage","death","travel","career","gains","loss"],"title":"Question","description":"Question category"},"target_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Date","description":"YYYY-MM-DD. Defaults to today (UTC)."},"target_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Time","description":"HH:MM (24h). Defaults to current time."},"target_timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Timezone","description":"IANA timezone for input date/time","default":"Asia/Kolkata"},"ayanamsa":{"type":"string","enum":["lahiri","kp"],"title":"Ayanamsa","description":"Ayanamsa system","default":"lahiri"}},"type":"object","required":["latitude","longitude","question"],"title":"PrashnaRequest"},"PrashnaResponse":{"properties":{"ayanamsa":{"type":"string","title":"Ayanamsa"},"question":{"type":"string","title":"Question"},"primary_house":{"type":"integer","title":"Primary House"},"ithsala_applying":{"type":"boolean","title":"Ithsala Applying"},"ithsala_separating":{"type":"boolean","title":"Ithsala Separating"},"query_utc":{"type":"string","title":"Query Utc"},"lagna":{"$ref":"#/components/schemas/PrashnaLagna"},"house_analysis":{"$ref":"#/components/schemas/PrashnaHouseAnalysis"},"moon":{"$ref":"#/components/schemas/PrashnaMoon"},"verdict":{"$ref":"#/components/schemas/PrashnaVerdict"},"planets":{"additionalProperties":{"$ref":"#/components/schemas/PrashnaPlanetSummary"},"type":"object","title":"Planets"},"house_cusps":{"additionalProperties":{"$ref":"#/components/schemas/PrashnaHouseCusp"},"type":"object","title":"House Cusps"}},"type":"object","required":["ayanamsa","question","primary_house","ithsala_applying","ithsala_separating","query_utc","lagna","house_analysis","moon","verdict","planets","house_cusps"],"title":"PrashnaResponse"},"PrashnaVerdict":{"properties":{"verdict":{"type":"string","title":"Verdict"},"confidence":{"type":"string","title":"Confidence"},"score":{"type":"integer","title":"Score"}},"type":"object","required":["verdict","confidence","score"],"title":"PrashnaVerdict"},"ProgressedPlanetSchema":{"properties":{"name":{"type":"string","title":"Name"},"longitude":{"type":"number","title":"Longitude"},"sign":{"type":"string","title":"Sign"},"sign_index":{"type":"integer","title":"Sign Index"},"degree_in_sign":{"type":"number","title":"Degree In Sign"},"is_retrograde":{"type":"boolean","title":"Is Retrograde"},"dignity":{"type":"string","title":"Dignity"},"dignity_score":{"type":"integer","title":"Dignity Score"}},"type":"object","required":["name","longitude","sign","sign_index","degree_in_sign","is_retrograde","dignity","dignity_score"],"title":"ProgressedPlanetSchema"},"ProgressionRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"target_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Date","description":"Target date for progressions YYYY-MM-DD. Defaults to today.","examples":["2026-05-01"]}},"type":"object","required":["date"],"title":"ProgressionRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"PujaSuggestionEntry":{"properties":{"puja_name":{"type":"string","title":"Puja Name"},"deity":{"type":"string","title":"Deity"},"day":{"type":"string","title":"Day"},"offerings":{"items":{"type":"string"},"type":"array","title":"Offerings"},"grain":{"type":"string","title":"Grain"},"mantra":{"type":"string","title":"Mantra"}},"type":"object","required":["puja_name","deity","day","offerings","grain","mantra"],"title":"PujaSuggestionEntry"},"PujaSuggestionSingleResponse":{"properties":{"puja_name":{"type":"string","title":"Puja Name"},"deity":{"type":"string","title":"Deity"},"day":{"type":"string","title":"Day"},"offerings":{"items":{"type":"string"},"type":"array","title":"Offerings"},"grain":{"type":"string","title":"Grain"},"mantra":{"type":"string","title":"Mantra"},"planet":{"type":"string","title":"Planet"}},"type":"object","required":["puja_name","deity","day","offerings","grain","mantra","planet"],"title":"PujaSuggestionSingleResponse"},"PujaSuggestionsAllResponse":{"properties":{"planets":{"additionalProperties":{"$ref":"#/components/schemas/PujaSuggestionEntry"},"type":"object","title":"Planets"}},"type":"object","required":["planets"],"title":"PujaSuggestionsAllResponse"},"RahuKaalResponse":{"properties":{"date":{"type":"string","title":"Date","description":"Date for which Rahu Kaal is calculated (YYYY-MM-DD)."},"sunrise":{"type":"string","title":"Sunrise","description":"Sunrise time in HH:MM local time."},"sunset":{"type":"string","title":"Sunset","description":"Sunset time in HH:MM local time."},"rahu_kaal":{"$ref":"#/components/schemas/KaalPeriod","description":"Rahu Kaal period — inauspicious for new beginnings."},"gulika_kaal":{"$ref":"#/components/schemas/KaalPeriod","description":"Gulika Kaal (Mandi) period — inauspicious."},"yamaganda_kaal":{"$ref":"#/components/schemas/KaalPeriod","description":"Yamaganda Kaal period — inauspicious."}},"type":"object","required":["date","sunrise","sunset","rahu_kaal","gulika_kaal","yamaganda_kaal"],"title":"RahuKaalResponse"},"RashiDrishtiEntry":{"properties":{"from_sign":{"type":"string","title":"From Sign","description":"Aspecting sign (Sanskrit)"},"from_sign_num":{"type":"integer","title":"From Sign Num","description":"Aspecting sign index 0-11"},"to_sign":{"type":"string","title":"To Sign","description":"Aspected sign (Sanskrit)"},"to_sign_num":{"type":"integer","title":"To Sign Num","description":"Aspected sign index 0-11"}},"type":"object","required":["from_sign","from_sign_num","to_sign","to_sign_num"],"title":"RashiDrishtiEntry"},"RemediesRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"top_n":{"type":"integer","maximum":9.0,"minimum":1.0,"title":"Top N","description":"Max planets to prescribe remedies for (1-9)","default":5}},"type":"object","required":["date"],"title":"RemediesRequest","description":"Personalised remedies — extends :class:`BirthInput` with ``top_n``.\n\nBirth fields: ``name``, ``date``, ``time``, ``location`` or ``latitude``/``longitude``/\n``timezone``, ``ayanamsa``. Additional: ``top_n`` (1–9).","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"RemediesResponse":{"properties":{"recommended_remedies":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recommended Remedies"},"planet_dignities":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Planet Dignities"}},"type":"object","required":["recommended_remedies","planet_dignities"],"title":"RemediesResponse"},"ReturnChartResponse":{"properties":{"planet":{"type":"string","title":"Planet"},"natal_longitude":{"type":"number","title":"Natal Longitude","description":"Natal longitude of the return planet (tropical)"},"return_utc":{"type":"string","title":"Return Utc","description":"Exact UTC moment of return (ISO 8601)","examples":["2026-11-12T08:23:41Z"]},"return_jd":{"type":"number","title":"Return Jd","description":"Julian Day of return moment"},"chart":{"$ref":"#/components/schemas/WesternNatalResponse","description":"Full Western natal chart calculated for the return moment"}},"type":"object","required":["planet","natal_longitude","return_utc","return_jd","chart"],"title":"ReturnChartResponse"},"RudrakshaAllResponse":{"properties":{"planets":{"additionalProperties":{"$ref":"#/components/schemas/RudrakshaEntry"},"type":"object","title":"Planets"}},"type":"object","required":["planets"],"title":"RudrakshaAllResponse"},"RudrakshaEntry":{"properties":{"mukhi":{"type":"integer","title":"Mukhi"},"presiding_deity":{"type":"string","title":"Presiding Deity"},"mantra":{"type":"string","title":"Mantra"},"metal":{"type":"string","title":"Metal"},"wearing_day":{"type":"string","title":"Wearing Day"},"mala_beads":{"type":"integer","title":"Mala Beads"},"wearing_finger":{"type":"string","title":"Wearing Finger"},"benefits":{"type":"string","title":"Benefits"}},"type":"object","required":["mukhi","presiding_deity","mantra","metal","wearing_day","mala_beads","wearing_finger","benefits"],"title":"RudrakshaEntry"},"RudrakshaSingleResponse":{"properties":{"mukhi":{"type":"integer","title":"Mukhi"},"presiding_deity":{"type":"string","title":"Presiding Deity"},"mantra":{"type":"string","title":"Mantra"},"metal":{"type":"string","title":"Metal"},"wearing_day":{"type":"string","title":"Wearing Day"},"mala_beads":{"type":"integer","title":"Mala Beads"},"wearing_finger":{"type":"string","title":"Wearing Finger"},"benefits":{"type":"string","title":"Benefits"},"planet":{"type":"string","title":"Planet"}},"type":"object","required":["mukhi","presiding_deity","mantra","metal","wearing_day","mala_beads","wearing_finger","benefits","planet"],"title":"RudrakshaSingleResponse"},"SadeSatiRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"check_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Check Date","description":"Date to check Sade Sati status. Defaults to today. Format: YYYY-MM-DD","examples":["2026-03-16"]}},"type":"object","required":["date"],"title":"SadeSatiRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"SadeSatiResponse":{"properties":{"natal_moon_sign":{"type":"string","title":"Natal Moon Sign"},"natal_moon_sign_index":{"type":"integer","title":"Natal Moon Sign Index"},"sade_sati_signs":{"additionalProperties":true,"type":"object","title":"Sade Sati Signs"},"is_currently_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Currently Active"},"current_phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Phase"},"current_phase_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Phase Description"},"intensity_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Intensity Score"},"intensity_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intensity Label"},"next_sade_sati":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Next Sade Sati"},"all_periods":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"All Periods"},"small_panoti":{"items":{"$ref":"#/components/schemas/SmallPanotiPeriod"},"type":"array","title":"Small Panoti"},"is_small_panoti_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Small Panoti Active"},"current_small_panoti_position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Small Panoti Position","description":"4 or 8 when Small Panoti is active (natal Moon reference)"},"mitigated_by_own_sign":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Mitigated By Own Sign"},"mitigated_by_exaltation":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Mitigated By Exaltation"}},"type":"object","required":["natal_moon_sign","natal_moon_sign_index","sade_sati_signs"],"title":"SadeSatiResponse"},"SahamEntry":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"theme":{"type":"string","title":"Theme"},"longitude":{"type":"number","title":"Longitude"},"rashi_index":{"type":"integer","title":"Rashi Index"},"rashi":{"type":"string","title":"Rashi"},"degree_in_sign":{"type":"number","title":"Degree In Sign"},"saham_lord":{"type":"string","title":"Saham Lord","description":"Classical lord of the sign where this Saham falls."},"formula_used":{"type":"string","title":"Formula Used","description":"Day or night formula and planet operands used."}},"type":"object","required":["slug","name","theme","longitude","rashi_index","rashi","degree_in_sign","saham_lord","formula_used"],"title":"SahamEntry"},"SahamResponse":{"properties":{"target_year":{"type":"integer","title":"Target Year"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"solar_return_utc":{"type":"string","title":"Solar Return Utc"},"is_day_return":{"type":"boolean","title":"Is Day Return","description":"True if solar return occurred during daytime — determines formula variant."},"varshaphal_ascendant_longitude":{"type":"number","title":"Varshaphal Ascendant Longitude"},"total":{"type":"integer","title":"Total"},"sahams":{"items":{"$ref":"#/components/schemas/SahamEntry"},"type":"array","title":"Sahams"}},"type":"object","required":["target_year","ayanamsa","solar_return_utc","is_day_return","varshaphal_ascendant_longitude","total","sahams"],"title":"SahamResponse"},"SecondaryProgressionResponse":{"properties":{"target_date":{"type":"string","title":"Target Date"},"progressed_jd":{"type":"number","title":"Progressed Jd"},"age_years":{"type":"number","title":"Age Years","description":"Age in tropical years at target date"},"solar_arc":{"type":"number","title":"Solar Arc","description":"Solar arc in degrees (~1° per year)"},"natal_sun_longitude":{"type":"number","title":"Natal Sun Longitude"},"progressed_sun_longitude":{"type":"number","title":"Progressed Sun Longitude"},"progressed_planets":{"items":{"$ref":"#/components/schemas/ProgressedPlanetSchema"},"type":"array","title":"Progressed Planets"},"progressed_ascendant":{"type":"number","title":"Progressed Ascendant"},"progressed_ascendant_sign":{"type":"string","title":"Progressed Ascendant Sign"},"progressed_mc":{"type":"number","title":"Progressed Mc"},"progressed_mc_sign":{"type":"string","title":"Progressed Mc Sign"}},"type":"object","required":["target_date","progressed_jd","age_years","solar_arc","natal_sun_longitude","progressed_sun_longitude","progressed_planets","progressed_ascendant","progressed_ascendant_sign","progressed_mc","progressed_mc_sign"],"title":"SecondaryProgressionResponse"},"SmallPanotiPeriod":{"properties":{"panoti_number":{"type":"integer","title":"Panoti Number"},"sign_index":{"type":"integer","title":"Sign Index"},"sign":{"type":"string","title":"Sign"},"position_from_moon":{"type":"integer","title":"Position From Moon"},"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"is_currently_active":{"type":"boolean","title":"Is Currently Active"},"duration_years":{"type":"number","title":"Duration Years"}},"type":"object","required":["panoti_number","sign_index","sign","position_from_moon","start","end","is_currently_active","duration_years"],"title":"SmallPanotiPeriod","description":"Saturn transit through 4th or 8th sign from natal Moon (Dhaiya / Small Panoti)."},"SolarArcPlanetSchema":{"properties":{"name":{"type":"string","title":"Name"},"natal_longitude":{"type":"number","title":"Natal Longitude"},"directed_longitude":{"type":"number","title":"Directed Longitude"},"sign":{"type":"string","title":"Sign"},"sign_index":{"type":"integer","title":"Sign Index"},"degree_in_sign":{"type":"number","title":"Degree In Sign"},"dignity":{"type":"string","title":"Dignity"},"dignity_score":{"type":"integer","title":"Dignity Score"}},"type":"object","required":["name","natal_longitude","directed_longitude","sign","sign_index","degree_in_sign","dignity","dignity_score"],"title":"SolarArcPlanetSchema"},"SolarArcResponse":{"properties":{"target_date":{"type":"string","title":"Target Date"},"solar_arc":{"type":"number","title":"Solar Arc","description":"Solar arc in degrees applied to all planets"},"age_years":{"type":"number","title":"Age Years"},"natal_sun_longitude":{"type":"number","title":"Natal Sun Longitude"},"progressed_sun_longitude":{"type":"number","title":"Progressed Sun Longitude"},"directed_planets":{"items":{"$ref":"#/components/schemas/SolarArcPlanetSchema"},"type":"array","title":"Directed Planets"},"directed_ascendant":{"type":"number","title":"Directed Ascendant"},"directed_ascendant_sign":{"type":"string","title":"Directed Ascendant Sign"},"directed_mc":{"type":"number","title":"Directed Mc"},"directed_mc_sign":{"type":"string","title":"Directed Mc Sign"}},"type":"object","required":["target_date","solar_arc","age_years","natal_sun_longitude","progressed_sun_longitude","directed_planets","directed_ascendant","directed_ascendant_sign","directed_mc","directed_mc_sign"],"title":"SolarArcResponse"},"SolarReturnRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"year":{"type":"integer","title":"Year","description":"Year for the solar return (e.g. 2026)","examples":[2026]}},"type":"object","required":["date","year"],"title":"SolarReturnRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"SpreadRequest":{"properties":{"allow_reversed":{"type":"boolean","title":"Allow Reversed","description":"If true, each card has a 50% chance of appearing reversed.","default":false},"question":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Question","description":"Optional question or intention for the reading.","examples":["What should I focus on in my career this month?"]}},"type":"object","title":"SpreadRequest"},"SpreadResponse":{"properties":{"spread_type":{"type":"string","title":"Spread Type","description":"Spread type: 'three_card' or 'celtic_cross'"},"positions":{"items":{"$ref":"#/components/schemas/DrawnCardSchema"},"type":"array","title":"Positions"},"question":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Question","description":"The question posed, if provided"}},"type":"object","required":["spread_type","positions"],"title":"SpreadResponse"},"StationEvent":{"properties":{"planet":{"type":"string","title":"Planet","description":"Planet name. Rahu and Ketu never have station events."},"station_type":{"type":"string","enum":["retrograde","direct"],"title":"Station Type","description":"retrograde — planet appears to reverse direction. direct — planet resumes forward motion."},"jd":{"type":"number","title":"Jd","description":"Julian Day number of the station moment"},"date_iso":{"type":"string","title":"Date Iso","description":"Date of station in YYYY-MM-DD format"},"longitude":{"type":"number","title":"Longitude","description":"Sidereal longitude of the planet at the moment of station"}},"type":"object","required":["planet","station_type","jd","date_iso","longitude"],"title":"StationEvent"},"StrengthRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"StrengthRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"StrengthResponse":{"additionalProperties":true,"type":"object","title":"StrengthResponse","description":"Strength report root. Includes ``shadbala``, ``bhavbala`` (keys ``\"1\"``…``\"12\"`` with\n``bhavadhipati_bala``, ``bhava_dig_bala``, ``bhava_drik_bala``, ``total``), ``vimshopaka_bala``\n(per-planet sixteen-varga score and threshold), ``divisional_charts``, ``ashtakavarga``, ``karakas``,\n``birth_time_provided``, and optional ``graha_yuddha``."},"SynastryAspectSchema":{"properties":{"person1_planet":{"type":"string","title":"Person1 Planet"},"person2_planet":{"type":"string","title":"Person2 Planet"},"type":{"type":"string","title":"Type"},"exact_angle":{"type":"number","title":"Exact Angle"},"orb":{"type":"number","title":"Orb"}},"type":"object","required":["person1_planet","person2_planet","type","exact_angle","orb"],"title":"SynastryAspectSchema"},"SynastryResponse":{"properties":{"aspects":{"items":{"$ref":"#/components/schemas/SynastryAspectSchema"},"type":"array","title":"Aspects"},"total_aspects":{"type":"integer","title":"Total Aspects"}},"type":"object","required":["aspects","total_aspects"],"title":"SynastryResponse"},"TamilKaalPeriod":{"properties":{"start":{"type":"string","title":"Start","description":"Period start time in HH:MM local time."},"end":{"type":"string","title":"End","description":"Period end time in HH:MM local time."},"duration_minutes":{"type":"integer","title":"Duration Minutes","description":"Duration in minutes."},"is_active":{"type":"boolean","title":"Is Active","description":"True if this period is currently active."}},"type":"object","required":["start","end","duration_minutes","is_active"],"title":"TamilKaalPeriod"},"TamilNallaNeramWindow":{"properties":{"start":{"type":"string","title":"Start","description":"Auspicious window start in HH:MM local time."},"end":{"type":"string","title":"End","description":"Auspicious window end in HH:MM local time."}},"type":"object","required":["start","end"],"title":"TamilNallaNeramWindow"},"TamilPanchangaResponse":{"properties":{"date":{"type":"string","title":"Date","description":"Date for which Tamil Panchanga is calculated (YYYY-MM-DD)."},"sunrise":{"type":"string","title":"Sunrise","description":"Sunrise time in HH:MM local time."},"sunset":{"type":"string","title":"Sunset","description":"Sunset time in HH:MM local time."},"tamil_month":{"type":"string","title":"Tamil Month","description":"Tamil solar month name based on Sun's sidereal sign at sunrise."},"rahu_kalam":{"$ref":"#/components/schemas/TamilKaalPeriod","description":"Rahu Kalam — inauspicious period, avoid new beginnings."},"yamagandam":{"$ref":"#/components/schemas/TamilKaalPeriod","description":"Yamagandam — inauspicious period associated with Yama."},"kuligai":{"$ref":"#/components/schemas/TamilKaalPeriod","description":"Kuligai (Gulika) — inauspicious period associated with Mandi."},"emagandam":{"$ref":"#/components/schemas/TamilKaalPeriod","description":"Emagandam — 4th Tamil inauspicious period."},"nalla_neram":{"items":{"$ref":"#/components/schemas/TamilNallaNeramWindow"},"type":"array","title":"Nalla Neram","description":"Auspicious daytime windows between the four inauspicious periods."}},"type":"object","required":["date","sunrise","sunset","tamil_month","rahu_kalam","yamagandam","kuligai","emagandam","nalla_neram"],"title":"TamilPanchangaResponse"},"TarabalaDetail":{"properties":{"tara_number":{"type":"integer","title":"Tara Number"},"count_from_birth":{"type":"integer","title":"Count From Birth"},"name":{"type":"string","title":"Name"},"meaning":{"type":"string","title":"Meaning"},"is_favorable":{"type":"boolean","title":"Is Favorable"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["tara_number","count_from_birth","name","meaning","is_favorable","interpretation"],"title":"TarabalaDetail"},"TarotCardSchema":{"properties":{"id":{"type":"string","title":"Id","description":"Unique slug identifier e.g. 'the-fool'"},"name":{"type":"string","title":"Name","description":"Full card name e.g. 'The Fool'"},"arcana_type":{"type":"string","title":"Arcana Type","description":"'major' or 'minor'"},"suit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suit","description":"Suit for minor arcana: wands, cups, swords, pentacles. Null for major arcana."},"number":{"type":"integer","title":"Number","description":"Card number. Major arcana: 0-21. Minor arcana: 1=Ace, 11=Page, 12=Knight, 13=Queen, 14=King."},"element":{"type":"string","title":"Element","description":"Elemental correspondence: fire, water, air, earth, spirit"},"astrology_correspondence":{"type":"string","title":"Astrology Correspondence","description":"Astrological planet or sign correspondence"},"keywords_upright":{"items":{"type":"string"},"type":"array","title":"Keywords Upright","description":"Upright keywords"},"keywords_reversed":{"items":{"type":"string"},"type":"array","title":"Keywords Reversed","description":"Reversed keywords"},"upright_meaning":{"type":"string","title":"Upright Meaning","description":"Full upright interpretation"},"reversed_meaning":{"type":"string","title":"Reversed Meaning","description":"Full reversed interpretation"},"yes_no":{"type":"string","title":"Yes No","description":"Yes/No polarity: 'yes', 'no', or 'maybe'"},"description":{"type":"string","title":"Description","description":"Visual description of the card imagery"}},"type":"object","required":["id","name","arcana_type","number","element","astrology_correspondence","keywords_upright","keywords_reversed","upright_meaning","reversed_meaning","yes_no","description"],"title":"TarotCardSchema"},"ThirumanaPoruthamRequest":{"properties":{"person1":{"$ref":"#/components/schemas/BirthInput","description":"Groom (boy) birth details. In Tamil Thirumana Porutham, person1 is the groom."},"person2":{"$ref":"#/components/schemas/BirthInput","description":"Bride (girl) birth details. In Tamil Thirumana Porutham, person2 is the bride."}},"type":"object","required":["person1","person2"],"title":"ThirumanaPoruthamRequest"},"ThirumanaPoruthamResponse":{"properties":{"total_passed":{"type":"integer","title":"Total Passed"},"total_poruthams":{"type":"integer","title":"Total Poruthams"},"compatibility_level":{"type":"string","title":"Compatibility Level"},"rajju_veto":{"type":"boolean","title":"Rajju Veto"},"vedha_veto":{"type":"boolean","title":"Vedha Veto"},"hard_veto":{"type":"boolean","title":"Hard Veto"},"rajju_severity":{"type":"integer","title":"Rajju Severity"},"rajju_severity_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rajju Severity Label"},"tradition":{"type":"string","title":"Tradition"},"breakdown":{"additionalProperties":true,"type":"object","title":"Breakdown"}},"type":"object","required":["total_passed","total_poruthams","compatibility_level","rajju_veto","vedha_veto","hard_veto","rajju_severity","rajju_severity_label","tradition","breakdown"],"title":"ThirumanaPoruthamResponse"},"TimezoneResponse":{"properties":{"latitude":{"type":"number","title":"Latitude","description":"Input latitude."},"longitude":{"type":"number","title":"Longitude","description":"Input longitude."},"timezone":{"type":"string","title":"Timezone","description":"IANA timezone identifier."}},"type":"object","required":["latitude","longitude","timezone"],"title":"TimezoneResponse"},"TithiData":{"properties":{"number":{"type":"integer","title":"Number","description":"Tithi number, 1 to 30"},"name":{"type":"string","title":"Name","description":"Tithi name, e.g. Pratipada, Purnima, Amavasya"},"paksha":{"type":"string","title":"Paksha","description":"Paksha — Shukla (waxing) or Krishna (waning)"},"degrees_elapsed":{"type":"number","title":"Degrees Elapsed","description":"Degrees completed within the current tithi"},"degrees_remaining":{"type":"number","title":"Degrees Remaining","description":"Degrees remaining until the next tithi"},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time"}},"type":"object","required":["number","name","paksha","degrees_elapsed","degrees_remaining"],"title":"TithiData"},"TodayAngelNumberResponse":{"properties":{"number":{"type":"string","title":"Number","description":"Angel number sequence, e.g. '111', '1111'."},"theme":{"type":"string","title":"Theme","description":"Core theme of this angel number."},"message":{"type":"string","title":"Message","description":"Primary message of this angel number."},"guidance":{"type":"string","title":"Guidance","description":"Actionable guidance for this number."},"areas":{"items":{"type":"string"},"type":"array","title":"Areas","description":"Life areas associated with this number."},"date":{"type":"string","title":"Date","description":"Date for which this number was computed (YYYY-MM-DD)."},"daily_digit":{"type":"integer","title":"Daily Digit","description":"Reduced single digit from today's date (1-9)."},"angel_number":{"type":"string","title":"Angel Number","description":"The angel number sequence derived from today's date."}},"type":"object","required":["number","theme","message","guidance","areas","date","daily_digit","angel_number"],"title":"TodayAngelNumberResponse"},"TransitAspectSchema":{"properties":{"transit_planet":{"type":"string","title":"Transit Planet"},"natal_planet":{"type":"string","title":"Natal Planet"},"type":{"type":"string","title":"Type"},"exact_angle":{"type":"number","title":"Exact Angle"},"orb":{"type":"number","title":"Orb"},"is_applying":{"type":"boolean","title":"Is Applying"}},"type":"object","required":["transit_planet","natal_planet","type","exact_angle","orb","is_applying"],"title":"TransitAspectSchema"},"TransitMoonRef":{"properties":{"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_index":{"type":"integer","title":"Nakshatra Index"},"rashi_index":{"type":"integer","title":"Rashi Index"}},"type":"object","required":["nakshatra","nakshatra_index","rashi_index"],"title":"TransitMoonRef"},"TransitNakshatraQuality":{"properties":{"nakshatra":{"type":"string","title":"Nakshatra"},"quality_type":{"type":"string","title":"Quality Type"},"english":{"type":"string","title":"English"},"auspicious_for":{"items":{"type":"string"},"type":"array","title":"Auspicious For"},"inauspicious_for":{"items":{"type":"string"},"type":"array","title":"Inauspicious For"}},"type":"object","required":["nakshatra","quality_type","english","auspicious_for","inauspicious_for"],"title":"TransitNakshatraQuality"},"TransitPlanetRowSchema":{"properties":{"name":{"type":"string","title":"Name"},"longitude":{"type":"number","title":"Longitude"},"sign":{"type":"string","title":"Sign"},"sign_index":{"type":"integer","title":"Sign Index"},"degree_in_sign":{"type":"number","title":"Degree In Sign"},"is_retrograde":{"type":"boolean","title":"Is Retrograde"},"aspects_to_natal":{"items":{"$ref":"#/components/schemas/TransitAspectSchema"},"type":"array","title":"Aspects To Natal"}},"type":"object","required":["name","longitude","sign","sign_index","degree_in_sign","is_retrograde","aspects_to_natal"],"title":"TransitPlanetRowSchema"},"TransitsRequest":{"properties":{"from_date":{"type":"string","title":"From Date","description":"Start of the date range to scan, in YYYY-MM-DD format.","examples":["2026-01-01"]},"to_date":{"type":"string","title":"To Date","description":"End of the date range to scan, in YYYY-MM-DD format. Maximum range is 3 years (1095 days) from from_date.","examples":["2026-12-31"]}},"type":"object","required":["from_date","to_date"],"title":"TransitsRequest"},"TransitsResponse":{"properties":{"ingresses":{"items":{"$ref":"#/components/schemas/IngressEvent"},"type":"array","title":"Ingresses","description":"All sign ingress events in the requested date range. Includes all 9 Vedic planets: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu."},"stations":{"items":{"$ref":"#/components/schemas/StationEvent"},"type":"array","title":"Stations","description":"All retrograde and direct station events in the requested date range. Only the 7 classical planets (Sun through Saturn) have stations. Rahu and Ketu are always excluded from this list."}},"type":"object","required":["ingresses","stations"],"title":"TransitsResponse"},"TwoPersonRequest":{"properties":{"person1":{"$ref":"#/components/schemas/BirthInput"},"person2":{"$ref":"#/components/schemas/BirthInput"}},"type":"object","required":["person1","person2"],"title":"TwoPersonRequest"},"UpapadaLagna":{"properties":{"sign_index":{"type":"integer","title":"Sign Index","description":"Upapada Lagna sign index 0–11"},"sign_name":{"type":"string","title":"Sign Name","description":"Sanskrit sign name of Upapada Lagna"},"upapada_lord":{"type":"string","title":"Upapada Lord","description":"Lord of the Upapada sign"},"second_from_upapada_sign_index":{"type":"integer","title":"Second From Upapada Sign Index","description":"Sign index 0–11 of the sign second from Upapada Lagna"},"second_from_upapada_sign_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Second From Upapada Sign Name","description":"Sanskrit sign name of the second from Upapada Lagna."},"planets_in_second_from_upapada":{"items":{"type":"string"},"type":"array","title":"Planets In Second From Upapada","description":"Grahas occupying the sign second from Upapada"},"has_benefic_in_second_from_upapada":{"type":"boolean","title":"Has Benefic In Second From Upapada","description":"True if a benefic occupies the 2nd-from-Upapada sign"},"has_malefic_in_second_from_upapada":{"type":"boolean","title":"Has Malefic In Second From Upapada","description":"True if a malefic occupies the 2nd-from-Upapada sign"}},"type":"object","required":["sign_index","sign_name","upapada_lord","second_from_upapada_sign_index","has_benefic_in_second_from_upapada","has_malefic_in_second_from_upapada"],"title":"UpapadaLagna","description":"Upapada Lagna (#142): Arudha of 12th house plus 2nd-from-Upapada analysis."},"VaraData":{"properties":{"number":{"type":"integer","title":"Number","description":"Weekday number, 1 to 7"},"name":{"type":"string","title":"Name","description":"Weekday name in Sanskrit, e.g. Ravivar, Somvar"},"lord":{"type":"string","title":"Lord","description":"Planetary lord of the weekday, e.g. Sun, Moon"},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time"}},"type":"object","required":["number","name","lord"],"title":"VaraData"},"VarshaPati":{"properties":{"planet":{"type":"string","title":"Planet"},"role":{"type":"string","title":"Role"},"pancha_vargeeya_bala":{"type":"number","title":"Pancha Vargeeya Bala"},"kshetra_bala":{"type":"number","title":"Kshetra Bala"},"uchcha_bala":{"type":"number","title":"Uchcha Bala"},"election_fallback":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Election Fallback","description":"When set, Varsha Pati was elected by fallback rather than highest aspecting score. Currently only 'muntha_pati_no_aspect'."},"moon_election":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Moon Election","description":"Moon election outcome: 'cancer_lagna_exception', 'nocturnal_tri_rasi_exception', 'disqualified', or null."}},"type":"object","required":["planet","role","pancha_vargeeya_bala","kshetra_bala","uchcha_bala"],"title":"VarshaPati"},"VarshaphalMuntha":{"properties":{"rashi_index":{"type":"integer","title":"Rashi Index"},"rashi":{"type":"string","title":"Rashi"},"age_years":{"type":"integer","title":"Age Years"},"muntha_lord":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Muntha Lord"}},"type":"object","required":["rashi_index","rashi","age_years"],"title":"VarshaphalMuntha"},"VarshaphalPlanet":{"properties":{"longitude":{"type":"number","title":"Longitude"},"rashi_index":{"type":"integer","title":"Rashi Index"},"rashi":{"type":"string","title":"Rashi"},"degree":{"type":"number","title":"Degree"},"is_retrograde":{"type":"boolean","title":"Is Retrograde"},"speed":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Speed"}},"type":"object","required":["longitude","rashi_index","rashi","degree","is_retrograde"],"title":"VarshaphalPlanet"},"VarshaphalRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"target_year":{"type":"integer","maximum":2100.0,"minimum":1800.0,"title":"Target Year","description":"Year for solar return e.g. 2026"}},"type":"object","required":["date","target_year"],"title":"VarshaphalRequest","description":"Varshaphal — extends :class:`BirthInput` with ``target_year``.\n\nBirth fields: ``name``, ``date``, ``time``, ``location`` or coordinates, ``ayanamsa``.\nRequired: ``target_year`` (solar return year).","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"VarshaphalResponse":{"properties":{"target_year":{"type":"integer","title":"Target Year"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"solar_return_utc":{"type":"string","title":"Solar Return Utc"},"solar_return_jd":{"type":"number","title":"Solar Return Jd"},"natal_sun_longitude":{"type":"number","title":"Natal Sun Longitude"},"natal_lagna":{"type":"string","title":"Natal Lagna"},"natal_lagna_index":{"type":"integer","title":"Natal Lagna Index"},"year_lord":{"type":"string","title":"Year Lord"},"muntha":{"$ref":"#/components/schemas/VarshaphalMuntha"},"planets":{"additionalProperties":{"$ref":"#/components/schemas/VarshaphalPlanet"},"type":"object","title":"Planets"},"varshaphal_ascendant_longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Varshaphal Ascendant Longitude","description":"Sidereal ascendant longitude at solar return (degrees)."},"varshaphal_ascendant_sign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Varshaphal Ascendant Sign","description":"Sanskrit sign name of the Varshaphal ascendant."},"varshaphal_ascendant_sign_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Varshaphal Ascendant Sign Index","description":"Sign index 0-11 of the Varshaphal ascendant."},"varsha_pati":{"$ref":"#/components/schemas/VarshaPati"},"pancha_adhikaris":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Pancha Adhikaris"},"pancha_vargeeya_bala":{"additionalProperties":{"type":"number"},"type":"object","title":"Pancha Vargeeya Bala"},"tajika_aspects":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tajika Aspects"},"tajika_planet_pairs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tajika Planet Pairs"}},"type":"object","required":["target_year","ayanamsa","solar_return_utc","solar_return_jd","natal_sun_longitude","natal_lagna","natal_lagna_index","year_lord","muntha","planets","varsha_pati","pancha_adhikaris","pancha_vargeeya_bala","tajika_aspects","tajika_planet_pairs"],"title":"VarshaphalResponse"},"WeeklyTransitResponse":{"properties":{"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"days":{"items":{"$ref":"#/components/schemas/DailyTransitResponse"},"type":"array","title":"Days"},"peak_aspects":{"items":{"$ref":"#/components/schemas/TransitAspectSchema"},"type":"array","title":"Peak Aspects"}},"type":"object","required":["start_date","end_date","days","peak_aspects"],"title":"WeeklyTransitResponse"},"WesternAngle":{"properties":{"longitude":{"type":"number","title":"Longitude","description":"Tropical ecliptic longitude 0–360°"},"sign":{"type":"string","title":"Sign","description":"Zodiac sign name","examples":["Scorpio"]},"sign_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign Index","description":"Sign index 0=Aries … 11=Pisces"},"degree_in_sign":{"type":"number","title":"Degree In Sign","description":"Degrees within sign 0–29.999"}},"type":"object","required":["longitude","sign","sign_index","degree_in_sign"],"title":"WesternAngle"},"WesternAspect":{"properties":{"planet_a":{"type":"string","title":"Planet A"},"planet_b":{"type":"string","title":"Planet B"},"type":{"type":"string","title":"Type","description":"Aspect type: conjunction | opposition | trine | square | sextile | semisextile | semisquare | sesquiquadrate | quincunx"},"exact_angle":{"type":"number","title":"Exact Angle","description":"Actual angular distance between planets"},"orb":{"type":"number","title":"Orb","description":"Difference from exact aspect angle (always positive)"},"is_applying":{"type":"boolean","title":"Is Applying","description":"True if the faster planet is moving toward exact aspect (orb decreasing)."}},"type":"object","required":["planet_a","planet_b","type","exact_angle","orb","is_applying"],"title":"WesternAspect"},"WesternAspectsRequest":{"properties":{"positions":{"additionalProperties":{"type":"number"},"type":"object","title":"Positions","description":"Dictionary of body name to tropical ecliptic longitude (0-360). Example: {\"Sun\": 229.6, \"Moon\": 221.8, \"Mars\": 189.6}","examples":[{"Mars":189.6,"Moon":221.8,"Sun":229.6}]},"orbs":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Orbs","description":"Custom orbs per aspect type. If omitted, uses standard modern Western orbs: major=5°, sextile=3°, minor=1.5°"}},"type":"object","required":["positions"],"title":"WesternAspectsRequest"},"WesternAspectsResponse":{"properties":{"aspects":{"items":{"$ref":"#/components/schemas/WesternAspect"},"type":"array","title":"Aspects","description":"All active aspects between the provided bodies"},"orbs_used":{"additionalProperties":{"type":"number"},"type":"object","title":"Orbs Used","description":"Orb values used for this calculation"},"body_count":{"type":"integer","title":"Body Count","description":"Number of bodies provided"},"aspect_count":{"type":"integer","title":"Aspect Count","description":"Number of aspects found"}},"type":"object","required":["aspects","orbs_used","body_count","aspect_count"],"title":"WesternAspectsResponse"},"WesternElements":{"properties":{"fire":{"type":"integer","title":"Fire"},"earth":{"type":"integer","title":"Earth"},"air":{"type":"integer","title":"Air"},"water":{"type":"integer","title":"Water"},"dominant":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dominant","description":"Most common element, or null if tied"}},"type":"object","required":["fire","earth","air","water"],"title":"WesternElements"},"WesternHemisphere":{"properties":{"eastern":{"type":"integer","title":"Eastern","description":"Planet count in houses 7–12"},"western":{"type":"integer","title":"Western","description":"Planet count in houses 1–6"},"northern":{"type":"integer","title":"Northern","description":"Planet count in houses 1–6 (below horizon)"},"southern":{"type":"integer","title":"Southern","description":"Planet count in houses 7–12 (above horizon)"}},"type":"object","required":["eastern","western","northern","southern"],"title":"WesternHemisphere"},"WesternHoroscopeChapter":{"properties":{"chapter_number":{"type":"integer","title":"Chapter Number"},"start_date":{"type":"string","title":"Start Date","description":"Chapter start date (YYYY-MM-DD)"},"end_date":{"type":"string","title":"End Date","description":"Chapter end date (YYYY-MM-DD)"},"title":{"type":"string","title":"Title"},"narrative":{"type":"string","title":"Narrative"}},"type":"object","required":["chapter_number","start_date","end_date","title","narrative"],"title":"WesternHoroscopeChapter"},"WesternHoroscopeContent":{"properties":{"headline":{"type":"string","title":"Headline"},"narrative":{"type":"string","title":"Narrative"},"career":{"type":"string","title":"Career"},"money":{"type":"string","title":"Money"},"love":{"type":"string","title":"Love"},"body":{"type":"string","title":"Body"},"power_window":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Power Window","description":"Favorable action window with tropical transit context"},"caution_window":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caution Window","description":"Cautious or low-energy window with tropical transit context"},"closing_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Closing Message","description":"Shareable closing line for the period"},"phases":{"anyOf":[{"items":{"$ref":"#/components/schemas/HoroscopePhase"},"type":"array"},{"type":"null"}],"title":"Phases","description":"Monthly: phased breakdown"},"year_theme":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Year Theme","description":"Yearly: tropical theme for the year"},"chapters":{"anyOf":[{"items":{"$ref":"#/components/schemas/WesternHoroscopeChapter"},"type":"array"},{"type":"null"}],"title":"Chapters","description":"Yearly: chapter breakdown"},"auspicious_months":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Auspicious Months","description":"Yearly: auspicious month names"},"landmark_dates":{"anyOf":[{"items":{"$ref":"#/components/schemas/WesternHoroscopeLandmarkDate"},"type":"array"},{"type":"null"}],"title":"Landmark Dates","description":"Yearly: key dates"}},"type":"object","required":["headline","narrative","career","money","love","body"],"title":"WesternHoroscopeContent","description":"Stored Western tropical horoscope prose; no remedy field."},"WesternHoroscopeData":{"properties":{"content":{"$ref":"#/components/schemas/WesternHoroscopeContent"},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At","description":"ISO timestamp when the horoscope was generated (UTC)"},"period_key":{"type":"string","title":"Period Key","description":"Period identifier (date, week, month, or year key)"},"horizon":{"type":"string","title":"Horizon","description":"Horizon: daily, weekly, monthly, or yearly"},"sun_sign":{"type":"string","title":"Sun Sign","description":"Normalised English tropical Sun sign slug"},"zodiac_type":{"type":"string","title":"Zodiac Type","description":"Always western for these endpoints"}},"type":"object","required":["content","period_key","horizon","sun_sign","zodiac_type"],"title":"WesternHoroscopeData","description":"Payload returned by Western horoscope GET endpoints."},"WesternHoroscopeLandmarkDate":{"properties":{"date":{"type":"string","title":"Date","description":"Landmark date (YYYY-MM-DD)"},"event":{"type":"string","title":"Event"}},"type":"object","required":["date","event"],"title":"WesternHoroscopeLandmarkDate"},"WesternHouseCusp":{"properties":{"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"cusp_longitude":{"type":"number","title":"Cusp Longitude","description":"Tropical ecliptic longitude of house cusp"},"sign":{"type":"string","title":"Sign"},"sign_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign Index"},"degree_in_sign":{"type":"number","title":"Degree In Sign"}},"type":"object","required":["house","cusp_longitude","sign","sign_index","degree_in_sign"],"title":"WesternHouseCusp"},"WesternModalities":{"properties":{"cardinal":{"type":"integer","title":"Cardinal"},"fixed":{"type":"integer","title":"Fixed"},"mutable":{"type":"integer","title":"Mutable"},"dominant":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dominant"}},"type":"object","required":["cardinal","fixed","mutable"],"title":"WesternModalities"},"WesternNatalRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"house_system":{"type":"string","enum":["placidus","koch","equal","whole_sign"],"title":"House System","description":"House system for Western natal chart. Placidus is the modern default. Koch is the second most popular. Equal and Whole Sign are sign-based systems.","default":"placidus","examples":["placidus"]}},"type":"object","required":["date"],"title":"WesternNatalRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"WesternNatalResponse":{"properties":{"zodiac":{"type":"string","title":"Zodiac","description":"Always 'tropical' for Western natal","default":"tropical"},"house_system":{"type":"string","title":"House System","description":"House system used","examples":["placidus"]},"ascendant":{"$ref":"#/components/schemas/WesternAngle"},"mc":{"$ref":"#/components/schemas/WesternAngle","description":"Midheaven (Medium Coeli)"},"planets":{"items":{"$ref":"#/components/schemas/WesternPlanetPosition"},"type":"array","title":"Planets"},"houses":{"items":{"$ref":"#/components/schemas/WesternHouseCusp"},"type":"array","title":"Houses"},"aspects":{"items":{"$ref":"#/components/schemas/WesternAspect"},"type":"array","title":"Aspects"},"elements":{"$ref":"#/components/schemas/WesternElements"},"modalities":{"$ref":"#/components/schemas/WesternModalities"},"hemisphere":{"$ref":"#/components/schemas/WesternHemisphere"},"ayanamsa_value":{"type":"number","title":"Ayanamsa Value","description":"Always 0.0 — tropical zodiac","default":0.0},"ayanamsa_used":{"type":"string","title":"Ayanamsa Used","default":"tropical"},"birth_time_provided":{"type":"boolean","title":"Birth Time Provided","description":"Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.","default":true}},"type":"object","required":["house_system","ascendant","mc","planets","houses","aspects","elements","modalities","hemisphere"],"title":"WesternNatalResponse"},"WesternPlanetPosition":{"properties":{"name":{"type":"string","title":"Name","description":"Planet name","examples":["Sun"]},"longitude":{"type":"number","title":"Longitude","description":"Tropical ecliptic longitude 0–360°"},"sign":{"type":"string","title":"Sign","description":"Zodiac sign name","examples":["Scorpio"]},"sign_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign Index"},"degree_in_sign":{"type":"number","title":"Degree In Sign","description":"Degrees within sign 0–29.999"},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House","description":"House number (Placidus or chosen system)"},"is_retrograde":{"type":"boolean","title":"Is Retrograde"},"dignity":{"type":"string","title":"Dignity","description":"Essential dignity: domicile | exaltation | detriment | fall | peregrine","examples":["peregrine"]},"dignity_score":{"type":"integer","title":"Dignity Score","description":"Essential dignity weight: domicile=5, exaltation=4, detriment=-5, fall=-4, peregrine=0"},"is_exaltation_degree":{"type":"boolean","title":"Is Exaltation Degree","description":"True if planet is in the exact classical exaltation degree (Nth degree = N-1°00' to N-1°59'59\"). Always false for outer planets (no exact degree defined)."},"dignity_disputed":{"type":"boolean","title":"Dignity Disputed","description":"True for outer planet (Uranus/Neptune/Pluto) exaltation/fall — no established consensus."}},"type":"object","required":["name","longitude","sign","sign_index","degree_in_sign","house","is_retrograde","dignity","dignity_score","is_exaltation_degree","dignity_disputed"],"title":"WesternPlanetPosition"},"WesternTransitRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Transit reference date (YYYY-MM-DD): snapshot day for daily transits; window start for weekly (7 days) and monthly (30 days). Defaults to today.","examples":["2026-05-01"]}},"type":"object","required":["date"],"title":"WesternTransitRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"YesNoRequest":{"properties":{"allow_reversed":{"type":"boolean","title":"Allow Reversed","description":"If true, reversed cards return 'maybe' instead of their base yes/no answer.","default":true},"question":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Question","description":"The yes/no question being asked.","examples":["Should I accept this job offer?"]}},"type":"object","title":"YesNoRequest"},"YesNoResponse":{"properties":{"card":{"$ref":"#/components/schemas/TarotCardSchema"},"is_reversed":{"type":"boolean","title":"Is Reversed"},"answer":{"type":"string","title":"Answer","description":"'yes', 'no', or 'maybe'"},"confidence":{"type":"string","title":"Confidence","description":"'strong' = card directly says yes/no. 'leaning' = reversed card. 'unclear' = maybe card."},"question":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Question"},"active_meaning":{"type":"string","title":"Active Meaning"}},"type":"object","required":["card","is_reversed","answer","confidence","active_meaning"],"title":"YesNoResponse"},"YogaData":{"properties":{"index":{"type":"integer","title":"Index","description":"Zero-based yoga index, 0 to 26"},"name":{"type":"string","title":"Name","description":"Yoga name, e.g. Vishkumbha, Shiva"},"is_inauspicious":{"type":"boolean","title":"Is Inauspicious","description":"True if this yoga is considered inauspicious"},"degrees_elapsed":{"type":"number","title":"Degrees Elapsed","description":"Degrees completed within the current yoga"},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time"}},"type":"object","required":["index","name","is_inauspicious","degrees_elapsed"],"title":"YogaData"},"YogaEndpointResponse":{"properties":{"yogas":{"items":{"$ref":"#/components/schemas/YogaResult"},"type":"array","title":"Yogas"},"birth_time_provided":{"type":"boolean","title":"Birth Time Provided","description":"Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.","default":true}},"type":"object","required":["yogas"],"title":"YogaEndpointResponse"},"YogaRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]}},"type":"object","required":["date"],"title":"YogaRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"YogaResult":{"properties":{"yoga_name":{"type":"string","title":"Yoga Name","description":"Detected yoga name","examples":["Gajakesari Yoga"]},"category":{"type":"string","title":"Category","description":"Yoga category bucket","examples":["raja_yogas"]},"formation":{"type":"string","title":"Formation","description":"Formation condition","examples":["Jupiter in Kendra from Moon"]},"modern_summary":{"type":"string","title":"Modern Summary","description":"Modern interpretation summary","examples":["Strong leadership yoga"]},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords","description":"Interpretation keywords","examples":[["leadership"]]}},"type":"object","required":["yoga_name","category","formation","modern_summary"],"title":"YogaResult"},"YoginiEndpointResponse":{"properties":{"periods":{"$ref":"#/components/schemas/YoginiResponse"},"birth_time_provided":{"type":"boolean","title":"Birth Time Provided","description":"Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.","default":true}},"type":"object","required":["periods"],"title":"YoginiEndpointResponse"},"YoginiPeriod":{"properties":{"yogini":{"type":"string","title":"Yogini","description":"Name of the Yogini ruling this period, e.g. Mangala, Pingala, Dhanya"},"planet":{"type":"string","title":"Planet","description":"Planetary lord of this Yogini"},"start_jd":{"type":"number","title":"Start Jd","description":"Start of period as Julian Day number"},"end_jd":{"type":"number","title":"End Jd","description":"End of period as Julian Day number"},"start_date":{"type":"string","title":"Start Date","description":"Start date in DD/MM/YYYY format"},"end_date":{"type":"string","title":"End Date","description":"End date in DD/MM/YYYY format"},"sub":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Sub","description":"Sub-periods (Antar Dasha). Present only when levels=2."}},"type":"object","required":["yogini","planet","start_jd","end_jd","start_date","end_date"],"title":"YoginiPeriod"},"YoginiRequest":{"properties":{"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.","examples":["Mumbai"]},"name":{"type":"string","minLength":1,"title":"Name","description":"Person name associated with the birth record","default":"Chart","examples":["Arjun Mehta"]},"date":{"type":"string","title":"Date","description":"Birth date in YYYY-MM-DD format","examples":["1985-11-12"]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","description":"Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.","examples":["06:45"]},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude. Required if location not provided.","examples":[19.055]},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude. Required if location not provided.","examples":[72.8692]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"IANA timezone. Required if location not provided.","examples":["Asia/Kolkata"]},"ayanamsa":{"type":"string","enum":["lahiri","raman","kp","tropical"],"title":"Ayanamsa","description":"Sidereal ayanamsa mode used in calculations","default":"lahiri","examples":["lahiri"]},"levels":{"type":"integer","maximum":2.0,"minimum":1.0,"title":"Levels","description":"Depth of sub-periods to return. 1 returns Maha Dashas only. 2 returns Maha and Antar Dashas. Maximum is 2.","default":2}},"type":"object","required":["date"],"title":"YoginiRequest","example":{"ayanamsa":"lahiri","date":"1985-11-12","latitude":19.055,"location":"Mumbai","longitude":72.8692,"name":"Arjun Mehta","time":"06:45","timezone":"Asia/Kolkata"}},"YoginiResponse":{"properties":{"root":{"items":{"$ref":"#/components/schemas/YoginiPeriod"},"type":"array","title":"Root"}},"type":"object","required":["root"],"title":"YoginiResponse"},"ZodiacCompatibilityResponse":{"properties":{"sign1":{"type":"string","title":"Sign1"},"sign2":{"type":"string","title":"Sign2"},"element1":{"type":"string","title":"Element1"},"element2":{"type":"string","title":"Element2"},"modality1":{"type":"string","title":"Modality1"},"modality2":{"type":"string","title":"Modality2"},"element_affinity":{"type":"string","title":"Element Affinity"},"modality_affinity":{"type":"string","title":"Modality Affinity"},"overall_score":{"type":"integer","title":"Overall Score"},"description":{"type":"string","title":"Description"}},"type":"object","required":["sign1","sign2","element1","element2","modality1","modality2","element_affinity","modality_affinity","overall_score","description"],"title":"ZodiacCompatibilityResponse"},"app__api__response__ApiResponse_CompatibilityResponse___1":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/app__api__schemas__western__CompatibilityResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[CompatibilityResponse]"},"app__api__response__ApiResponse_CompatibilityResponse___2":{"properties":{"success":{"type":"boolean","title":"Success","description":"True if the request succeeded","default":true},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"success"},"data":{"$ref":"#/components/schemas/app__api__schemas__numerology__CompatibilityResponse","description":"The endpoint response payload"}},"type":"object","required":["data"],"title":"ApiResponse[CompatibilityResponse]"},"app__api__schemas__numerology__CompatibilityResponse":{"properties":{"life_path_1":{"type":"integer","title":"Life Path 1","description":"First person's life path number"},"life_path_2":{"type":"integer","title":"Life Path 2","description":"Second person's life path number"},"compatibility_score":{"type":"integer","title":"Compatibility Score","description":"Compatibility score (1-10)"},"compatibility_level":{"type":"string","title":"Compatibility Level","description":"Compatibility level (Excellent, Good, Fair, Challenging)"},"interpretation":{"type":"string","title":"Interpretation","description":"Detailed compatibility interpretation"},"strengths":{"items":{"type":"string"},"type":"array","title":"Strengths","description":"Relationship strengths"},"challenges":{"items":{"type":"string"},"type":"array","title":"Challenges","description":"Potential challenges"},"advice":{"type":"string","title":"Advice","description":"Relationship advice"}},"type":"object","required":["life_path_1","life_path_2","compatibility_score","compatibility_level","interpretation","advice"],"title":"CompatibilityResponse"},"app__api__schemas__western__CompatibilityResponse":{"properties":{"overall_score":{"type":"integer","title":"Overall Score"},"element_score":{"type":"integer","title":"Element Score"},"aspect_score":{"type":"integer","title":"Aspect Score"},"sun_sign_affinity":{"type":"string","title":"Sun Sign Affinity"},"moon_sign_affinity":{"type":"string","title":"Moon Sign Affinity"},"rising_sign_affinity":{"type":"string","title":"Rising Sign Affinity"},"person1_sun":{"type":"string","title":"Person1 Sun"},"person2_sun":{"type":"string","title":"Person2 Sun"},"person1_moon":{"type":"string","title":"Person1 Moon"},"person2_moon":{"type":"string","title":"Person2 Moon"},"key_aspects":{"items":{"$ref":"#/components/schemas/SynastryAspectSchema"},"type":"array","title":"Key Aspects"}},"type":"object","required":["overall_score","element_score","aspect_score","sun_sign_affinity","moon_sign_affinity","rising_sign_affinity","person1_sun","person2_sun","person1_moon","person2_moon","key_aspects"],"title":"CompatibilityResponse"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Pass your Asterwise API key as a Bearer token. Example: Authorization: Bearer aw_live_xxxx"}}},"tags":[{"name":"Utilities","description":"Geocoding and timezone helpers."},{"name":"Astrology","description":"Core Vedic astrology calculations — natal charts, panchanga, dasha, doshas, yogas, matchmaking, sade sati."},{"name":"Advanced","description":"Advanced Vedic calculations — divisional charts, ashtakavarga, shadbala, gochar, yogini dasha, ashtottari dasha."},{"name":"Numerology","description":"Numerology calculations — life path, expression, soul urge, personal year, compatibility."},{"name":"Horoscope","description":"Daily, weekly, monthly, and yearly horoscopes by moon sign."},{"name":"KP","description":"Krishnamurti Paddhati — sub-lords, cuspal significations, KP chart, ruling planets."},{"name":"Lal Kitab","description":"Lal Kitab annual charts and planetary debt remedies."},{"name":"Prashna","description":"Prashna (horary) astrology — chart cast for the moment of a question."}],"servers":[{"url":"https://api.asterwise.com","description":"Production"}]}