{"openapi":"3.1.0","info":{"title":"Kundli API","version":"0.1.0","description":"Vedic birth chart, Vimshottari dasha, doshas, yogas, guna milan, transits, Western natal chart, sun signs and naming syllables — computed locally.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://kundli.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/kundli/docs"},"termsOfService":"https://connectorbay.com/kundli/terms"},"servers":[{"url":"https://kundli.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/kundli/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/birth_chart":{"post":{"operationId":"birth_chart","summary":"Vedic janma kundli: lagna, nine grahas with rashi/nakshatra/pada/house/navamsa/dignity/retrograde/combust,","description":"Vedic janma kundli: lagna, nine grahas with rashi/nakshatra/pada/house/navamsa/dignity/retrograde/combust,\n    twelve bhavas with lords and occupants, Moon and Sun signs, plus classic yogas. Use for \"my kundli\", \"what is my\n    lagna and moon sign\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Birth date YYYY-MM-DD.","examples":["1990-08-14"],"title":"Date","type":"string"},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Local birth time HH:MM (24h). Omit if unknown (noon assumed; lagna approximate).","examples":["06:35"],"title":"Time"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Birth place 'city, country' or 'city, state'.","examples":["Pune, India","Toronto, Canada"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Or coordinates.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"},"include_yogas":{"default":true,"description":"Include classic yogas.","title":"Include Yogas","type":"boolean"}},"required":["date"],"title":"birth_chartArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/dasha":{"post":{"operationId":"dasha","summary":"Vimshottari dasha: the current mahadasha and antardasha, and the full mahadasha timeline with sub-periods.","description":"Vimshottari dasha: the current mahadasha and antardasha, and the full mahadasha timeline with sub-periods.\n    Use for \"which dasha am I running\", \"when does my Saturn mahadasha end\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Birth date YYYY-MM-DD.","examples":["1990-08-14"],"title":"Date","type":"string"},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Local birth time HH:MM (24h). Omit if unknown (noon assumed; lagna approximate).","examples":["06:35"],"title":"Time"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Birth place 'city, country' or 'city, state'.","examples":["Pune, India","Toronto, Canada"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Or coordinates.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"},"years":{"default":120,"description":"How many years of the timeline to return.","maximum":120,"minimum":10,"title":"Years","type":"integer"}},"required":["date"],"title":"dashaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/doshas":{"post":{"operationId":"doshas","summary":"Manglik (Mangal dosha) from lagna and Moon with common cancellations, Kaal Sarp dosha, and whether Sade Sati or","description":"Manglik (Mangal dosha) from lagna and Moon with common cancellations, Kaal Sarp dosha, and whether Sade Sati or\n    Dhaiya is running today. Use for \"am I manglik\", \"is my sade sati going on\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Birth date YYYY-MM-DD.","examples":["1990-08-14"],"title":"Date","type":"string"},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Local birth time HH:MM (24h). Omit if unknown (noon assumed; lagna approximate).","examples":["06:35"],"title":"Time"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Birth place 'city, country' or 'city, state'.","examples":["Pune, India","Toronto, Canada"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Or coordinates.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"}},"required":["date"],"title":"doshasArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/guna_milan":{"post":{"operationId":"guna_milan","summary":"Ashtakoota (36-guna) compatibility from both Moon positions: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana,","description":"Ashtakoota (36-guna) compatibility from both Moon positions: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana,\n    Bhakoot, Nadi with scores, doshas and a verdict, plus both Manglik statuses. Use for \"match our kundlis\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"bride_date":{"description":"Bride's birth date YYYY-MM-DD.","title":"Bride Date","type":"string"},"groom_date":{"description":"Groom's birth date YYYY-MM-DD.","title":"Groom Date","type":"string"},"bride_time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"HH:MM local.","title":"Bride Time"},"groom_time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"HH:MM local.","title":"Groom Time"},"bride_place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City, country.","title":"Bride Place"},"groom_place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City, country.","title":"Groom Place"}},"required":["bride_date","groom_date"],"title":"guna_milanArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/transits":{"post":{"operationId":"transits","summary":"Gochar: where every graha is today (or on a date) relative to the natal Moon and lagna, with the classical","description":"Gochar: where every graha is today (or on a date) relative to the natal Moon and lagna, with the classical\n    favourable/mixed reading, plus Sade Sati status. Use for \"what are my transits this month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Birth date YYYY-MM-DD.","examples":["1990-08-14"],"title":"Date","type":"string"},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Local birth time HH:MM (24h). Omit if unknown (noon assumed; lagna approximate).","examples":["06:35"],"title":"Time"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Birth place 'city, country' or 'city, state'.","examples":["Pune, India","Toronto, Canada"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Or coordinates.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"},"on":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date to check, YYYY-MM-DD (default today).","title":"On"}},"required":["date"],"title":"transitsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/nakshatra_profile":{"post":{"operationId":"nakshatra_profile","summary":"The birth nakshatra (from birth details) or any nakshatra by name: deity, symbol, lord, gana, rashi, qualities","description":"The birth nakshatra (from birth details) or any nakshatra by name: deity, symbol, lord, gana, rashi, qualities\n    and the four naming syllables — with the pada and syllable for a birth. Use for \"naming letters for a baby born\n    …\", \"what does Rohini nakshatra mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"description":"Birth date YYYY-MM-DD.","examples":["1990-08-14"],"type":"string"},{"type":"null"}],"default":null,"title":"Date"},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Local birth time HH:MM (24h). Omit if unknown (noon assumed; lagna approximate).","examples":["06:35"],"title":"Time"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Birth place 'city, country' or 'city, state'.","examples":["Pune, India","Toronto, Canada"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Or coordinates.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Or just a nakshatra name.","examples":["Rohini","Ashwini"],"title":"Name"}},"title":"nakshatra_profileArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/western_chart":{"post":{"operationId":"western_chart","summary":"Tropical natal chart: Sun, Moon and rising ('big three'), planets incl. Uranus/Neptune/Pluto and North Node in","description":"Tropical natal chart: Sun, Moon and rising ('big three'), planets incl. Uranus/Neptune/Pluto and North Node in\n    signs and whole-sign houses with retrogrades, major aspects with orbs, element and modality balance. Use for\n    \"what's my rising sign\", \"my natal chart\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Birth date YYYY-MM-DD.","examples":["1990-08-14"],"title":"Date","type":"string"},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Local birth time HH:MM (24h). Omit if unknown (noon assumed; lagna approximate).","examples":["06:35"],"title":"Time"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Birth place 'city, country' or 'city, state'.","examples":["Pune, India","Toronto, Canada"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"description":"Or coordinates.","title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"}},"required":["date"],"title":"western_chartArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/sun_sign":{"post":{"operationId":"sun_sign","summary":"Western sun sign for a birthday with element, modality, ruler, symbol and traits, plus the Vedic (sidereal)","description":"Western sun sign for a birthday with element, modality, ruler, symbol and traits, plus the Vedic (sidereal)\n    Sun sign for comparison. Use for \"what star sign is 14 August\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"birthday":{"description":"Birthday YYYY-MM-DD or MM-DD.","examples":["1990-08-14","08-14"],"title":"Birthday","type":"string"}},"required":["birthday"],"title":"sun_signArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}