{"openapi":"3.1.0","info":{"title":"vedicAPI v1","version":"1.0.0","description":"Vedic astrology API for developers: charts, dasha, panchang, matching, muhurta, 601 scored yogas and tarot. Names and labels in 12 languages. Send your API key as a Bearer token. The Free plan has every endpoint."},"servers":[{"url":"https://api.vedicapi.co/v1"}],"security":[{"bearer":[]}],"tags":[{"name":"Charts","description":"Charts: Planets, Houses, Divisional charts, Chart image, Moon, Sun, Chalit, Chart PDF, Full kundli."},{"name":"Dasha","description":"Dasha: Vimshottari dasha, Current dasha."},{"name":"Strength","description":"Strength: Ashtakavarga, Shadbala, Jaimini, Upagrahas."},{"name":"Yogas and doshas","description":"Yogas and doshas: Yogas, Doshas."},{"name":"Panchang","description":"Panchang: Panchang, Inauspicious times, Tarabala."},{"name":"Transits","description":"Transits: Current transits."},{"name":"Matching","description":"Matching: Ashtakoot matching."},{"name":"Muhurta","description":"Muhurta: Find a muhurta, Muhurta purposes, Marriage muhurta, Childbirth muhurta."},{"name":"Horoscope","description":"Horoscope: Daily horoscope."},{"name":"Remedies","description":"Remedies: Gemstone."},{"name":"Tarot","description":"Tarot: Tarot draw."},{"name":"Places","description":"Places: Place search."},{"name":"Account","description":"Account: Request logs, Usage."}],"paths":{"/chart/planets":{"post":{"operationId":"chart-planets","summary":"Planets","description":"Planet positions with sign, house, degree, nakshatra, pada, retrograde, combustion and planetary war, plus the ascendant and the ayanamsa used. Counts as 1 API call.","tags":["Charts"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"ascendant":{"degree":18.4405,"house":1,"id":"Ascendant","longitude":108.4405,"nakshatra":"Ashlesha","nakshatra_lord":"Mercury","name":"Ascendant","pada":1,"sign":"Cancer","sign_no":4},"ayanamsa":{"degree":23.732164,"mean_degree":23.728604,"name":"lahiri","note":"degree is the true value (with nutation), the one the positions use"},"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"lang":"en","node":"mean","planets":[{"combust":false,"degree":3.4072,"house":4,"id":"Sun","longitude":183.4072,"nakshatra":"Chitra","nakshatra_lord":"Mars","name":"Sun","pada":4,"planet_war":false,"retro":false,"sign":"Libra","sign_no":7},{"combust":false,"degree":27.3645,"house":4,"id":"Moon","longitude":207.3645,"nakshatra":"Vishakha","nakshatra_lord":"Jupiter","name":"Moon","pada":3,"planet_war":false,"retro":false,"sign":"Libra","sign_no":7},{"combust":false,"degree":20.8309,"house":11,"id":"Mars","longitude":50.8309,"nakshatra":"Rohini","nakshatra_lord":"Moon","name":"Mars","pada":4,"planet_war":false,"retro":true,"sign":"Taurus","sign_no":2},{"combust":true,"degree":2.4626,"house":4,"id":"Mercury","longitude":182.4626,"nakshatra":"Chitra","nakshatra_lord":"Mars","name":"Mercury","pada":3,"planet_war":false,"retro":false,"sign":"Libra","sign_no":7},{"combust":false,"degree":17.3435,"house":1,"id":"Jupiter","longitude":107.3435,"nakshatra":"Ashlesha","nakshatra_lord":"Mercury","name":"Jupiter","pada":1,"planet_war":false,"retro":false,"sign":"Cancer","sign_no":4},{"combust":true,"degree":0.3796,"house":4,"id":"Venus","longitude":180.3796,"nakshatra":"Chitra","nakshatra_lord":"Mars","name":"Venus","pada":3,"planet_war":false,"retro":false,"sign":"Libra","sign_no":7},{"combust":false,"degree":25.5962,"house":6,"id":"Saturn","longitude":265.5962,"nakshatra":"Purva Ashadha","nakshatra_lord":"Venus","name":"Saturn","pada":4,"planet_war":false,"retro":false,"sign":"Sagittarius","sign_no":9},{"combust":false,"degree":9.2246,"house":7,"id":"Rahu","longitude":279.2246,"nakshatra":"Uttara Ashadha","nakshatra_lord":"Sun","name":"Rahu","pada":4,"planet_war":false,"retro":true,"sign":"Capricorn","sign_no":10},{"combust":false,"degree":9.2246,"house":1,"id":"Ketu","longitude":99.2246,"nakshatra":"Pushya","nakshatra_lord":"Saturn","name":"Ketu","pada":2,"planet_war":false,"retro":true,"sign":"Cancer","sign_no":4}],"units":1,"request_id":"req_5aBVztrmYk"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/chart/houses":{"post":{"operationId":"chart-houses","summary":"Houses","description":"The 12 whole-sign houses: sign, lord, the planets in each, and the planets that aspect it. Counts as 1 API call.","tags":["Charts"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"ascendant":{"degree":18.4405,"house":1,"id":"Ascendant","longitude":108.4405,"nakshatra":"Ashlesha","nakshatra_lord":"Mercury","name":"Ascendant","pada":1,"sign":"Cancer","sign_no":4},"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"houses":[{"aspected_by":["Rahu"],"aspected_by_id":["Rahu"],"house":1,"lord":"Moon","planet_ids":["Jupiter","Ketu"],"planets":["Jupiter","Ketu"],"sign":"Cancer","sign_no":4},{"aspected_by":["Mars"],"aspected_by_id":["Mars"],"house":2,"lord":"Sun","planet_ids":[],"planets":[],"sign":"Leo","sign_no":5},{"aspected_by":["Saturn","Rahu"],"aspected_by_id":["Saturn","Rahu"],"house":3,"lord":"Mercury","planet_ids":[],"planets":[],"sign":"Virgo","sign_no":6},"... 12 items in all"],"lang":"en","system":"whole_sign","units":1,"request_id":"req_NEqPFL3ZTK"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/chart/divisional/{chart}":{"post":{"operationId":"chart-divisional","summary":"Divisional charts","description":"Any of 18 divisional charts from D1 to D60. D9 also lists the vargottama planets. Counts as 1 API call.","tags":["Charts"],"parameters":[{"$ref":"#/components/parameters/X-End-User"},{"name":"chart","in":"path","required":true,"description":"Divisional chart.","schema":{"type":"string","description":"Divisional chart.","enum":["D1","D2","D3","D3-s","D7","D9","D10","D10-R","D11","D12","D16","D20","D24","D24-R","D30","D40","D45","D60"],"examples":["D9"]}}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"ascendant":{"degree":1.7738,"house":1,"id":"Ascendant","name":"Ascendant","sign":"Sagittarius","sign_no":9},"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"chart":"D9","lang":"en","planets":[{"degree":0.0739,"house":12,"id":"Sun","name":"Sun","retro":false,"sign":"Scorpio","sign_no":8},{"degree":0.6978,"house":7,"id":"Moon","name":"Moon","retro":false,"sign":"Gemini","sign_no":3},{"degree":0.8309,"house":8,"id":"Mars","name":"Mars","retro":true,"sign":"Cancer","sign_no":4},{"degree":2.4626,"house":11,"id":"Mercury","name":"Mercury","retro":false,"sign":"Libra","sign_no":7},{"degree":0.6768,"house":1,"id":"Jupiter","name":"Jupiter","retro":false,"sign":"Sagittarius","sign_no":9},{"degree":0.3796,"house":11,"id":"Venus","name":"Venus","retro":false,"sign":"Libra","sign_no":7},{"degree":2.2629,"house":12,"id":"Saturn","name":"Saturn","retro":false,"sign":"Scorpio","sign_no":8},{"degree":2.5579,"house":4,"id":"Rahu","name":"Rahu","retro":true,"sign":"Pisces","sign_no":12},{"degree":2.5579,"house":10,"id":"Ketu","name":"Ketu","retro":true,"sign":"Virgo","sign_no":6}],"vargottama":["Mercury","Venus"],"units":1,"request_id":"req_KgpqwRRzce"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/chart/image/{chart}":{"post":{"operationId":"chart-image","summary":"Chart image","description":"SVG or PNG of a chart in North, South or East Indian style. Labels follow lang. Counts as 1 API call.","tags":["Charts"],"parameters":[{"$ref":"#/components/parameters/X-End-User"},{"name":"chart","in":"path","required":true,"description":"Any divisional chart (D1 to D60), or moon, sun or chalit.","schema":{"type":"string","description":"Any divisional chart (D1 to D60), or moon, sun or chalit.","enum":["D1","D2","D3","D3-s","D7","D9","D10","D10-R","D11","D12","D16","D20","D24","D24-R","D30","D40","D45","D60","moon","sun","chalit"],"examples":["D1"]}}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"chart":"D1","format":"svg","lang":"en","style":"north","svg":"<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 300 300\" width=\"300\" height ... </svg>","units":1,"request_id":"req_pSsRYMzsjh"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]},"style":{"type":"string","description":"Chart style. Default north.","enum":["north","south","east"],"examples":["north"]},"format":{"type":"string","description":"Image format. Default svg. PNG comes back as png_url, a link that works for an hour.","enum":["svg","png"],"examples":["svg"]},"size":{"type":"integer","description":"PNG width and height in pixels, 150 to 2000. Values outside are clamped. Default 600.","examples":[600]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en","style":"north","format":"svg","size":600}}}}}},"/chart/special/{kind}":{"post":{"operationId":"chart-special","summary":"Moon, Sun, Chalit","description":"The chart from the Moon or the Sun as the first house, and the bhava chalit chart. Counts as 1 API call.","tags":["Charts"],"parameters":[{"$ref":"#/components/parameters/X-End-User"},{"name":"kind","in":"path","required":true,"description":"Which chart.","schema":{"type":"string","description":"Which chart.","enum":["moon","sun","chalit"],"examples":["moon"]}}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"ascendant":{"house":1,"id":"Ascendant","name":"Ascendant","sign":"Libra","sign_no":7},"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"kind":"moon","lang":"en","planets":[{"house":1,"id":"Sun","name":"Sun","retro":false,"sign":"Libra","sign_no":7},{"house":1,"id":"Moon","name":"Moon","retro":false,"sign":"Libra","sign_no":7},{"house":8,"id":"Mars","name":"Mars","retro":true,"sign":"Taurus","sign_no":2},{"house":1,"id":"Mercury","name":"Mercury","retro":false,"sign":"Libra","sign_no":7},{"house":10,"id":"Jupiter","name":"Jupiter","retro":false,"sign":"Cancer","sign_no":4},{"house":1,"id":"Venus","name":"Venus","retro":false,"sign":"Libra","sign_no":7},{"house":3,"id":"Saturn","name":"Saturn","retro":false,"sign":"Sagittarius","sign_no":9},{"house":4,"id":"Rahu","name":"Rahu","retro":true,"sign":"Capricorn","sign_no":10},{"house":10,"id":"Ketu","name":"Ketu","retro":true,"sign":"Cancer","sign_no":4}],"units":1,"request_id":"req_TSZRbYaWbr"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/chart/pdf":{"post":{"operationId":"chart-pdf","summary":"Chart PDF","description":"A 4-page PDF: D1, D9, Moon and chalit charts, planets, Vimshottari dasha and yogas. Names and labels follow lang. Comes back as pdf_url, a link that works for an hour. Counts as 5 API calls.","tags":["Charts"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"expires_in":3600,"lang":"en","pages":4,"pdf_url":"https://api.vedicapi.co/v1/files/f_8mjMMCwgr759c363NeQc9SQ6ZoDpC0rR.pdf","style":"north","units":5,"request_id":"req_cyAwfLnPGH"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]},"style":{"type":"string","description":"Chart style. Default north.","enum":["north","south","east"],"examples":["north"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en","style":"north"}}}}}},"/kundli":{"post":{"operationId":"kundli","summary":"Full kundli","description":"The whole chart in one call, trimmed to the sections you ask for. The ascendant is always included. Counts as 5 API calls.","tags":["Charts"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"ascendant":{"degree":18.4405,"house":1,"id":"Ascendant","longitude":108.4405,"nakshatra":"Ashlesha","nakshatra_lord":"Mercury","name":"Ascendant","pada":1,"sign":"Cancer","sign_no":4},"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"dasha":{"antar_in_current_maha":[{"id":"Mercury","planet":"Mercury","from":"2016-12-18","to":"2019-05-17"},{"id":"Ketu","planet":"Ketu","from":"2019-05-17","to":"2020-05-13"},{"id":"Venus","planet":"Venus","from":"2020-05-13","to":"2023-03-14"},"... 9 items in all"],"as_of":"2026-11-22","current":{"antar":{"id":"Rahu","planet":"Rahu","from":"2026-06-16","to":"2029-01-02"},"antar_progress":0.171,"maha":{"id":"Mercury","planet":"Mercury","from":"2016-12-18","to":"2033-12-18"},"pratyantar":{"id":"Jupiter","planet":"Jupiter","from":"2026-11-02","to":"2027-03-07"}},"sequence":[{"id":"Jupiter","planet":"Jupiter","from":"1981-12-19","to":"1997-12-18"},{"id":"Saturn","planet":"Saturn","from":"1997-12-18","to":"2016-12-18"},{"id":"Mercury","planet":"Mercury","from":"2016-12-18","to":"2033-12-18"},"... 9 items in all"],"system":"vimshottari","year_days":365.2425},"houses":[{"aspected_by":["Rahu"],"aspected_by_id":["Rahu"],"house":1,"lord":"Moon","planet_ids":["Jupiter","Ketu"],"planets":["Jupiter","Ketu"],"sign":"Cancer","sign_no":4},{"aspected_by":["Mars"],"aspected_by_id":["Mars"],"house":2,"lord":"Sun","planet_ids":[],"planets":[],"sign":"Leo","sign_no":5},{"aspected_by":["Saturn","Rahu"],"aspected_by_id":["Saturn","Rahu"],"house":3,"lord":"Mercury","planet_ids":[],"planets":[],"sign":"Virgo","sign_no":6},"... 12 items in all"],"lang":"en","planets":[{"combust":false,"degree":3.4072,"house":4,"id":"Sun","longitude":183.4072,"nakshatra":"Chitra","nakshatra_lord":"Mars","name":"Sun","pada":4,"planet_war":false,"retro":false,"sign":"Libra","sign_no":7},{"combust":false,"degree":27.3645,"house":4,"id":"Moon","longitude":207.3645,"nakshatra":"Vishakha","nakshatra_lord":"Jupiter","name":"Moon","pada":3,"planet_war":false,"retro":false,"sign":"Libra","sign_no":7},{"combust":false,"degree":20.8309,"house":11,"id":"Mars","longitude":50.8309,"nakshatra":"Rohini","nakshatra_lord":"Moon","name":"Mars","pada":4,"planet_war":false,"retro":true,"sign":"Taurus","sign_no":2},"... 9 items in all"],"sections":["planets","houses","dasha","yogas"],"yogas":{"checked":601,"count":97,"present":[{"category":"Pancha Mahapurusha","gives":"beauty and comfort drawn near, magnetic charm, artistic fame, marital happiness","how_it_forms":"Venus sits in its own or exalted sign (Taurus, Libra or Pisces) in a Kendra (1st/4th/7th/10th). Strongest when reckoned from both Lagna and Moon and unafflicted.","name":"Maalavya Yoga","nature":"Highly Benefic","planets":["Venus"],"strength_percent":80,"text_lang":"en"},{"category":"Raja","gives":"rising in the world, position and recognition, doors that open for you, success like destiny","how_it_forms":"The lord of an angular house joins or aspects the lord of a trine house, uniting power with grace. Strongest when the yoga forms in a Kendra or Trikona with dignified planets.","name":"Rajayoga (General)","nature":"Benefic","planets":["Moon","Venus"],"strength_percent":78,"text_lang":"en"},{"category":"Wealth","gives":"self-made fortune, multiple income streams, entrepreneurial gains, wealth with staying power","how_it_forms":"The lords of the 1st, 2nd and 11th houses, self, savings and gains, connect by conjunction, aspect or exchange. Strongest when all three lords are dignified and angular.","name":"Dhana Yoga (1-2-11)","nature":"Benefic","planets":["Sun","Venus"],"strength_percent":75,"text_lang":"en"},"... 97 items in all"],"text_lang":"en"},"units":5,"request_id":"req_GnuVQLQoiu"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]},"sections":{"type":"string","description":"Comma separated: planets, houses, navamsa, dasha, ashtakavarga, shadbala, yogas, doshas, jaimini, remedies. Default all.","examples":["planets,houses,dasha,yogas"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en","sections":"planets,houses,dasha,yogas"}}}}}},"/dasha/vimshottari":{"post":{"operationId":"dasha-vimshottari","summary":"Vimshottari dasha","description":"The 9 maha dasha periods with dates, and the running maha, antar and pratyantar on any date. Counts as 1 API call.","tags":["Dasha"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"antar_in_current_maha":[{"id":"Mercury","planet":"Mercury","from":"2016-12-18","to":"2019-05-17"},{"id":"Ketu","planet":"Ketu","from":"2019-05-17","to":"2020-05-13"},{"id":"Venus","planet":"Venus","from":"2020-05-13","to":"2023-03-14"},"... 9 items in all"],"as_of":"2026-11-19","birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"current":{"antar":{"id":"Rahu","planet":"Rahu","from":"2026-06-16","to":"2029-01-02"},"antar_progress":0.168,"maha":{"id":"Mercury","planet":"Mercury","from":"2016-12-18","to":"2033-12-18"},"pratyantar":{"id":"Jupiter","planet":"Jupiter","from":"2026-11-02","to":"2027-03-07"}},"lang":"en","sequence":[{"id":"Jupiter","planet":"Jupiter","from":"1981-12-19","to":"1997-12-18"},{"id":"Saturn","planet":"Saturn","from":"1997-12-18","to":"2016-12-18"},{"id":"Mercury","planet":"Mercury","from":"2016-12-18","to":"2033-12-18"},{"id":"Ketu","planet":"Ketu","from":"2033-12-18","to":"2040-12-18"},{"id":"Venus","planet":"Venus","from":"2040-12-18","to":"2060-12-18"},{"id":"Sun","planet":"Sun","from":"2060-12-18","to":"2066-12-18"},{"id":"Moon","planet":"Moon","from":"2066-12-18","to":"2076-12-18"},{"id":"Mars","planet":"Mars","from":"2076-12-18","to":"2083-12-18"},{"id":"Rahu","planet":"Rahu","from":"2083-12-18","to":"2101-12-19"}],"system":"vimshottari","year_days":365.2425,"units":1,"request_id":"req_NxarptANQd"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]},"as_of":{"type":"string","description":"Date to read the running periods on, YYYY-MM-DD. Default today (UTC).","examples":["2026-11-19"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en","as_of":"2026-11-19"}}}}}},"/dasha/current":{"post":{"operationId":"dasha-current","summary":"Current dasha","description":"The running maha, antar and pratyantar dasha, each with its dates. Counts as 1 API call.","tags":["Dasha"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"as_of":"2026-11-19","birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"current":{"antar":{"id":"Rahu","planet":"Rahu","from":"2026-06-16","to":"2029-01-02"},"antar_progress":0.168,"maha":{"id":"Mercury","planet":"Mercury","from":"2016-12-18","to":"2033-12-18"},"pratyantar":{"id":"Jupiter","planet":"Jupiter","from":"2026-11-02","to":"2027-03-07"}},"lang":"en","units":1,"request_id":"req_36DTpZHysY"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]},"as_of":{"type":"string","description":"Date to read the periods on, YYYY-MM-DD. Default today (UTC).","examples":["2026-11-19"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en","as_of":"2026-11-19"}}}}}},"/ashtakavarga":{"post":{"operationId":"ashtakavarga","summary":"Ashtakavarga","description":"Bhinna ashtakavarga per planet and lagna, and the sarva totals per sign. Counts as 1 API call.","tags":["Strength"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"bhinna":{"Jupiter":[5,5,5,5,7,1,4,7,3,4,6,4],"Lagna":[2,6,1,5,4,4,5,3,6,4,3,7],"Mars":[2,4,3,3,6,3,1,1,7,0,3,6],"Mercury":[1,5,6,4,7,3,4,3,6,4,6,5],"Moon":[7,5,3,6,4,2,5,0,5,4,5,3],"Saturn":[4,5,2,4,4,4,4,2,3,1,2,4],"Sun":[3,4,5,4,5,4,3,3,6,3,2,6],"Venus":[3,5,3,4,6,5,5,4,3,3,6,5]},"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"lang":"en","order":["Aries","Taurus","Gemini","Cancer","Leo","Virgo","Libra","Scorpio","Sagittarius","Capricorn","Aquarius","Pisces"],"order_note":"Each list is in sign order, Aries first.","sarva":[25,33,27,30,39,22,26,20,33,19,30,33],"total":337,"units":1,"request_id":"req_vCWw6HQ96q"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/shadbala":{"post":{"operationId":"shadbala","summary":"Shadbala","description":"Six-fold strength of the 7 planets in virupas and rupas, against the required minimum. Counts as 1 API call.","tags":["Strength"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"lang":"en","note":"Ratio is total over the classical minimum; 1 or more is strong.","planets":[{"balas":{"cheshta":0.28,"dig":0.06,"drik":-0.18,"kala":2.98,"naisargika":1,"sthana":2.51},"id":"Sun","name":"Sun","ratio":1.33,"required_rupas":5,"strong":true,"total_rupas":6.64,"total_virupas":398.31},{"balas":{"cheshta":0.13,"dig":0.92,"drik":0.11,"kala":2.95,"naisargika":0.86,"sthana":2.34},"id":"Moon","name":"Moon","ratio":1.22,"required_rupas":6,"strong":true,"total_rupas":7.32,"total_virupas":439},{"balas":{"cheshta":0.87,"dig":0.79,"drik":-0.08,"kala":2.79,"naisargika":0.29,"sthana":1.75},"id":"Mars","name":"Mars","ratio":1.28,"required_rupas":5,"strong":true,"total_rupas":6.41,"total_virupas":384.6},{"balas":{"cheshta":0.06,"dig":0.59,"drik":-0.19,"kala":1.85,"naisargika":0.43,"sthana":3.22},"id":"Mercury","name":"Mercury","ratio":0.85,"required_rupas":7,"strong":false,"total_rupas":5.96,"total_virupas":357.42},{"balas":{"cheshta":0.47,"dig":0.99,"drik":-0.32,"kala":2.06,"naisargika":0.57,"sthana":4.49},"id":"Jupiter","name":"Jupiter","ratio":1.27,"required_rupas":6.5,"strong":true,"total_rupas":8.27,"total_virupas":496.43},{"balas":{"cheshta":0.02,"dig":0.93,"drik":-0.21,"kala":1.49,"naisargika":0.71,"sthana":3.86},"id":"Venus","name":"Venus","ratio":1.24,"required_rupas":5.5,"strong":true,"total_rupas":6.81,"total_virupas":408.32},{"balas":{"cheshta":0.46,"dig":0.87,"drik":-0.06,"kala":3.53,"naisargika":0.14,"sthana":2.6},"id":"Saturn","name":"Saturn","ratio":1.51,"required_rupas":5,"strong":true,"total_rupas":7.56,"total_virupas":453.45}],"units":1,"request_id":"req_R78VACdYcW"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/jaimini":{"post":{"operationId":"jaimini","summary":"Jaimini","description":"Chara karakas, arudha padas, upapada lagna and Indu lagna. Counts as 1 API call.","tags":["Strength"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"arudha_lagna":"Libra","arudhas":{"A1":"Libra","A10":"Gemini","A11":"Pisces","A12":"Aquarius","A2":"Sagittarius","A3":"Scorpio","A4":"Cancer","A5":"Pisces","A6":"Aquarius","A7":"Scorpio","A8":"Libra","A9":"Scorpio"},"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"indu_lagna":{"degree":27.3646,"sign":"Pisces"},"karakas":[{"degree":27.3645,"karaka":"Atmakaraka","planet":"Moon","planet_id":"Moon","signifies":"Soul"},{"degree":25.5962,"karaka":"Amatyakaraka","planet":"Saturn","planet_id":"Saturn","signifies":"Mind, Career"},{"degree":20.8309,"karaka":"Bhratrukaraka","planet":"Mars","planet_id":"Mars","signifies":"Siblings"},{"degree":17.3435,"karaka":"Matrukaraka","planet":"Jupiter","planet_id":"Jupiter","signifies":"Mother"},{"degree":3.4072,"karaka":"Pitrukaraka","planet":"Sun","planet_id":"Sun","signifies":"Father"},{"degree":2.4626,"karaka":"Putrakaraka","planet":"Mercury","planet_id":"Mercury","signifies":"Children"},{"degree":0.3796,"karaka":"Gnatikaraka","planet":"Venus","planet_id":"Venus","signifies":"Relatives"}],"lang":"en","upapada_lagna":"Aquarius","units":1,"request_id":"req_JC4yXxGooY"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/upagraha":{"post":{"operationId":"upagraha","summary":"Upagrahas","description":"Gulika, Mandi, Dhuma and the other shadow points: 11 in all, each with sign, degree and nakshatra. Counts as 1 API call.","tags":["Strength"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"lang":"en","upagrahas":{"artha_praharaka":{"degree":19.74,"house":10,"longitude":19.7449,"nakshatra":"Bharani","nakshatra_lord":"Venus","pada":2,"sign":"Aries","sign_no":1},"dhuma":{"degree":16.75,"house":8,"longitude":316.7463,"nakshatra":"Shatabhisha","nakshatra_lord":"Rahu","pada":4,"sign":"Aquarius","sign_no":11},"gulika":{"degree":19.79,"house":12,"longitude":79.7935,"nakshatra":"Ardra","nakshatra_lord":"Rahu","pada":4,"sign":"Gemini","sign_no":3},"indrachaapa":{"degree":16.75,"house":2,"longitude":136.7463,"nakshatra":"Purva Phalguni","nakshatra_lord":"Venus","pada":2,"sign":"Leo","sign_no":5},"kaala":{"degree":10.69,"house":2,"longitude":130.6945,"nakshatra":"Magha","nakshatra_lord":"Ketu","pada":4,"sign":"Leo","sign_no":5},"mandi":{"degree":0.05,"house":1,"longitude":90.0456,"nakshatra":"Punarvasu","nakshatra_lord":"Jupiter","pada":4,"sign":"Cancer","sign_no":4},"mrityu":{"degree":22.4,"house":3,"longitude":172.3989,"nakshatra":"Hasta","nakshatra_lord":"Moon","pada":4,"sign":"Virgo","sign_no":6},"parivesha":{"degree":13.25,"house":5,"longitude":223.2537,"nakshatra":"Anuradha","nakshatra_lord":"Saturn","pada":3,"sign":"Scorpio","sign_no":8},"upaketu":{"degree":3.41,"house":3,"longitude":153.4129,"nakshatra":"Uttara Phalguni","nakshatra_lord":"Sun","pada":3,"sign":"Virgo","sign_no":6},"vyatipaata":{"degree":13.25,"house":11,"longitude":43.2537,"nakshatra":"Rohini","nakshatra_lord":"Moon","pada":1,"sign":"Taurus","sign_no":2},"yama_ghantaka":{"degree":16.45,"house":11,"longitude":46.4535,"nakshatra":"Rohini","nakshatra_lord":"Moon","pada":2,"sign":"Taurus","sign_no":2}},"units":1,"request_id":"req_LMqoWeUFQa"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/yogas":{"post":{"operationId":"yogas","summary":"Yogas","description":"601 yogas checked. Each one present comes with its category, strength, how it forms and what it gives. How it forms and what it gives follow lang; yoga names, categories and nature stay in English. Counts as 5 API calls.","tags":["Yogas and doshas"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"checked":601,"count":97,"lang":"en","present":[{"category":"Pancha Mahapurusha","gives":"beauty and comfort drawn near, magnetic charm, artistic fame, marital happiness","how_it_forms":"Venus sits in its own or exalted sign (Taurus, Libra or Pisces) in a Kendra (1st/4th/7th/10th). Strongest when reckoned from both Lagna and Moon and unafflicted.","name":"Maalavya Yoga","nature":"Highly Benefic","planets":["Venus"],"strength_percent":80,"text_lang":"en"},{"category":"Raja","gives":"rising in the world, position and recognition, doors that open for you, success like destiny","how_it_forms":"The lord of an angular house joins or aspects the lord of a trine house, uniting power with grace. Strongest when the yoga forms in a Kendra or Trikona with dignified planets.","name":"Rajayoga (General)","nature":"Benefic","planets":["Moon","Venus"],"strength_percent":78,"text_lang":"en"},{"category":"Wealth","gives":"self-made fortune, multiple income streams, entrepreneurial gains, wealth with staying power","how_it_forms":"The lords of the 1st, 2nd and 11th houses, self, savings and gains, connect by conjunction, aspect or exchange. Strongest when all three lords are dignified and angular.","name":"Dhana Yoga (1-2-11)","nature":"Benefic","planets":["Sun","Venus"],"strength_percent":75,"text_lang":"en"},"... 97 items in all"],"text_lang":"en","units":5,"request_id":"req_wvJRmT8JVU"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/dosha/{kind}":{"post":{"operationId":"dosha","summary":"Doshas","description":"Mangal, Kaal Sarp, Pitra and Sade Sati: present or not, with the detail. Mangal also says whether it is partial or cancelled. Counts as 1 API call.","tags":["Yogas and doshas"],"parameters":[{"$ref":"#/components/parameters/X-End-User"},{"name":"kind","in":"path","required":true,"description":"Which dosha.","schema":{"type":"string","description":"Which dosha.","enum":["mangal","kaalsarp","pitra","sadesati"],"examples":["mangal"]}}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"detail":"Mangal Dosha is partial or cancelled. Mars is in the 8th house from the Moon. Mars is in the 8th house from Venus.","detail_lang":"en","from_lagna":false,"from_moon":true,"from_venus":true,"kind":"mangal","lang":"en","name":"Mangal Dosha","partial_or_cancelled":true,"present":true,"units":1,"request_id":"req_V6dvpFpHDc"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/panchang":{"post":{"operationId":"panchang","summary":"Panchang","description":"Tithi, nakshatra, yoga, karana, vara, sunrise and sunset for a date and place, with the day's windows: Rahu kaal, Yamaganda, Gulika, Abhijit, Durmuhurta and Varjyam. Counts as 1 API call.","tags":["Panchang"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"abhijit":{"end":"12:27:42","start":"11:45:03"},"computed_at":"12:00","date":"2026-11-19","day_length_hours":10.66,"durmuhurta":[{"end":"11:02:24","start":"10:19:45"},{"end":"15:18:18","start":"14:35:39"}],"gulika":{"end":"10:46:24","start":"09:26:26"},"karana":{"bhadra":false,"name":"Taitila","number":19},"lang":"en","nakshatra":{"lord":"Jupiter","name":"Purva Bhadrapada","number":25,"pada":1},"place":{"lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"rahu_kaal":{"end":"14:46:19","start":"13:26:21"},"sunrise":"06:46:29","sunset":"17:26:16","tithi":{"class":"Purna","name":"Shukla Dashami","number":10,"paksha":"Shukla"},"vara":"Thursday","varjyam":{"end":"14:25","start":"12:46"},"yamaganda":{"end":"08:06:27","start":"06:46:29"},"yoga":{"name":"Harshana","number":14},"units":1,"request_id":"req_EzfcU78gEx"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","description":"Date, YYYY-MM-DD.","examples":["2026-11-19"]},"lat":{"type":"number","description":"Latitude of the place.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the place.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"time":{"type":"string","description":"Local time the tithi, nakshatra, yoga and karana are read at, HH:MM. Default 12:00."}},"required":["date","lat","lon","tz"]},"example":{"date":"2026-11-19","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/panchang/inauspicious":{"post":{"operationId":"panchang-inauspicious","summary":"Inauspicious times","description":"Rahu kaal, Yamaganda, Gulika, Durmuhurta and Varjyam for a date and place, with Abhijit as the good window. Counts as 1 API call.","tags":["Panchang"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"abhijit":{"end":"12:27:42","start":"11:45:03"},"date":"2026-11-19","durmuhurta":[{"end":"11:02:24","start":"10:19:45"},{"end":"15:18:18","start":"14:35:39"}],"gulika":{"end":"10:46:24","start":"09:26:26"},"lang":"en","note":"Abhijit is the auspicious window; the others are times to avoid.","place":{"lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"rahu_kaal":{"end":"14:46:19","start":"13:26:21"},"sunrise":"06:46:29","sunset":"17:26:16","vara":"Thursday","varjyam":{"end":"14:25","start":"12:46"},"yamaganda":{"end":"08:06:27","start":"06:46:29"},"units":1,"request_id":"req_EGcuVAK7UP"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","description":"Date, YYYY-MM-DD.","examples":["2026-11-19"]},"lat":{"type":"number","description":"Latitude of the place.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the place.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]}},"required":["date","lat","lon","tz"]},"example":{"date":"2026-11-19","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/tarabala":{"post":{"operationId":"tarabala","summary":"Tarabala","description":"Tara bala and chandra bala for a birth chart on a date, with Chandrashtama. Counts as 1 API call.","tags":["Panchang"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"chandra_bala":{"chandrashtama":false,"good":false,"house":5},"date":"2026-11-19","janma_nakshatra":"Vishakha","janma_rashi":"Libra","lang":"en","tara":{"good":false,"name":"Janma","number":1,"verdict":"avoid major events"},"transit_moon_sign":"Aquarius","transit_nakshatra":"Purva Bhadrapada","units":1,"request_id":"req_xMP7wokSmo"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]},"date":{"type":"string","description":"Date to check, YYYY-MM-DD. Default today at the birth place.","examples":["2026-11-19"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en","date":"2026-11-19"}}}}}},"/transits/now":{"post":{"operationId":"transits","summary":"Current transits","description":"Where each planet is right now against the birth chart (house from lagna and from the Moon), and when it next changes sign. Counts as 1 API call.","tags":["Transits"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"as_of":"2026-11-22T16:17:50Z","birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"lang":"en","planets":[{"degree":6.14,"house_from_lagna":5,"house_from_moon":2,"id":"Sun","nakshatra":"Anuradha","name":"Sun","next_sign":{"on":"2026-12-16T10:25:02+05:30","reverts_at":null,"sign":"Sagittarius"},"retro":false,"sign":"Scorpio","sign_no":8},{"degree":9.43,"house_from_lagna":10,"house_from_moon":7,"id":"Moon","nakshatra":"Ashwini","name":"Moon","next_sign":{"on":"2026-11-24T07:24:50+05:30","reverts_at":null,"sign":"Taurus"},"retro":false,"sign":"Aries","sign_no":1},{"degree":4.42,"house_from_lagna":2,"house_from_moon":11,"id":"Mars","nakshatra":"Magha","name":"Mars","next_sign":{"on":"2027-03-10T00:13:22+05:30","reverts_at":"2027-04-26T11:47:14+05:30","sign":"Cancer"},"retro":false,"sign":"Leo","sign_no":5},"... 9 items in all"],"units":1,"request_id":"req_sdiSCB8a39"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/match/ashtakoot":{"post":{"operationId":"match-ashtakoot","summary":"Ashtakoot matching","description":"Guna milan out of 36: each of the 8 kootas, a one-word verdict, and the Nadi and Bhakoot dosha checks. Counts as 1 API call.","tags":["Matching"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"boy":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"doshas":{"bhakoot_dosha":false,"nadi_dosha":false},"girl":{"datetime":"1991-12-02T14:40","lat":19.076,"lon":72.8777,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"kootas":[{"about":"Work","boy_varna":"Vaishya","girl_varna":"Vaishya","got":1,"id":"varna","max":1,"name":"Varna"},{"about":"Innate Giving / Attraction towards each other","boy_vasya":"Manava","girl_vasya":"Manava","got":2,"id":"vasya","max":2,"name":"Vashya"},{"about":"Comfort - Prosperity - Health","boy_tara":"Mitra","girl_tara":"Vipat","got":1.5,"id":"tara","max":3,"name":"Tara"},{"about":"Intimacy","boy_yoni":"tiger","girl_yoni":"tiger","got":4,"id":"yoni","max":4,"name":"Yoni"},{"about":"Friendship","boy_lord":"venus","girl_lord":"venus","got":5,"id":"grahamaitri","max":5,"name":"Graha Maitri"},{"about":"Temperament","boy_gana":"rakshasa","girl_gana":"rakshasa","got":6,"id":"gana","max":6,"name":"Gana"},{"about":"Constructive Ability / Constructivism / Society and Couple","boy_rasi":7,"boy_rasi_name":"libra","girl_rasi":7,"girl_rasi_name":"libra","got":7,"id":"bhakoot","max":7,"name":"Bhakoot"},{"about":"Progeny","boy_nadi":"Antya","girl_nadi":"Madhya","got":8,"id":"nadi","max":8,"name":"Nadi"}],"lang":"en","max":36,"note":"18 or more is the usual minimum. Check Nadi and Bhakoot doshas and their cancellations separately.","total":34.5,"verdict":"Excellent","units":1,"request_id":"req_bHnW49Hdrz"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"boy":{"type":"object","description":"Birth details of the first person. An object with datetime, lat, lon and tz, the same as the birth fields.","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]}},"required":["datetime","lat","lon","tz"],"examples":[{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata"}]},"girl":{"type":"object","description":"Birth details of the second person. An object with datetime, lat, lon and tz, the same as the birth fields.","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]}},"required":["datetime","lat","lon","tz"],"examples":[{"datetime":"1991-12-02T14:40","lat":19.076,"lon":72.8777,"tz":"Asia/Kolkata"}]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]}},"required":["boy","girl"]},"example":{"boy":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata"},"girl":{"datetime":"1991-12-02T14:40","lat":19.076,"lon":72.8777,"tz":"Asia/Kolkata"},"lang":"en"}}}}}},"/muhurta/find":{"post":{"operationId":"muhurta-find","summary":"Find a muhurta","description":"Ranked windows for 23 purposes, each with its reasons. The birth fields are the person's. The event happens at the birth place unless you send place. Counts as 5 API calls. 10 API calls for a range over 90 days.","tags":["Muhurta"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"days_scanned":31,"days_usable":6,"from":"2026-12-01","lang":"en","purpose":"griha_pravesh","text_lang":"en","to":"2026-12-31","windows":[{"dasha":"Mercury","date":"2026-12-03","end":"08:07","kind":"moment","lagna":"Sagittarius","nakshatra":"Uttara Phalguni","rank":1,"reasons":["favourable birth star (Uttara Phalguni)","supportive Tarabala for you","clean rising sign (Lagna Shuddhi)","auspicious tithi"],"score":75.2,"start":"08:07","verdict":"Very good"},{"dasha":"Mercury","date":"2026-12-03","end":"07:57","kind":"window","lagna":"Scorpio","nakshatra":"Uttara Phalguni","rank":2,"reasons":["favourable birth star (Uttara Phalguni)","supportive Tarabala for you","auspicious tithi","clean rising sign (Lagna Shuddhi)"],"score":73.7,"start":"06:57","verdict":"Very good"},{"dasha":"Mercury","date":"2026-12-04","end":"17:18","kind":"window","lagna":"Taurus","nakshatra":"Chitra","rank":3,"reasons":["favourable birth star (Chitra)","supportive Tarabala for you","clean rising sign (Lagna Shuddhi)","auspicious tithi"],"score":72.7,"start":"16:18","verdict":"Very good"},{"dasha":"Mercury","date":"2026-12-04","end":"12:28","kind":"window","lagna":"Aquarius","nakshatra":"Chitra","rank":4,"reasons":["favourable birth star (Chitra)","supportive Tarabala for you","auspicious tithi","clean rising sign (Lagna Shuddhi)"],"score":70.5,"start":"11:58","verdict":"Very good"},{"dasha":"Mercury","date":"2026-12-04","end":"16:08","kind":"window","lagna":"Aries","nakshatra":"Chitra","rank":5,"reasons":["favourable birth star (Chitra)","supportive Tarabala for you","clean rising sign (Lagna Shuddhi)","auspicious tithi"],"score":70.5,"start":"15:18","verdict":"Very good"}],"units":5,"request_id":"req_tmrfz5sFsk"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]},"purpose":{"type":"string","description":"A key from GET /muhurta/purposes.","examples":["griha_pravesh"]},"from":{"type":"string","description":"Start date, YYYY-MM-DD.","examples":["2026-12-01"]},"to":{"type":"string","description":"End date, up to 180 days from the start.","examples":["2026-12-31"]},"top":{"type":"integer","description":"How many windows, 1 to 20. Default 5.","examples":[5]},"place":{"type":"object","description":"Where the event happens, if not at the birth place: lat, lon and tz.","properties":{"lat":{"type":"number","description":"Latitude.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]}},"required":["lat","lon","tz"]}},"required":["datetime","lat","lon","tz","purpose","from","to"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en","purpose":"griha_pravesh","from":"2026-12-01","to":"2026-12-31","top":5}}}}}},"/muhurta/purposes":{"get":{"operationId":"muhurta-purposes","summary":"Muhurta purposes","description":"The 23 purposes muhurta/find accepts, with their labels and categories. Free to call. Free to call.","tags":["Muhurta"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"also":["/v1/muhurta/marriage","/v1/muhurta/childbirth"],"purposes":[{"category":"home","key":"griha_pravesh","label":"Housewarming (Griha Pravesh)","needs_partner":false},{"category":"home","key":"bhoomi_puja","label":"Ground-breaking (Bhoomi Puja)","needs_partner":false},{"category":"career","key":"business_opening","label":"Business opening","needs_partner":false},"... 23 items in all"],"units":0,"request_id":"req_B2oBbk6PRV"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/muhurta/marriage":{"post":{"operationId":"muhurta-marriage","summary":"Marriage muhurta","description":"Ranked marriage dates for a couple, with their ashtakoota score. The wedding place is required. Counts as 5 API calls. 15 API calls for a range over 90 days, 25 over 180 days.","tags":["Muhurta"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"ashtakoota":{"out_of":36,"parts":{"bhakoot":7,"gana":6,"maitri":5,"nadi":8,"tara":1.5,"varna":1,"vasya":2,"yoni":4},"total":34.5,"verdict":"excellent"},"best_available":false,"boy":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"computed_ms":14072,"day_killed":{"Mula":2,"Tuesday":3,"bride":1,"dagdha":1,"groom":10,"nakshatra":97,"tithi":36},"days_scanned":366,"from":"2028-01-01","girl":{"datetime":"1991-12-02T14:40","lat":19.076,"lon":72.8777,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"lang":"en","season_killed":{"Chaturmas":90,"Guru asta":29,"Holashtak":7,"Kharmas":60,"Shukra asta":13},"text_lang":"en","to":"2028-12-31","trade_offs":[],"valid_days":5,"windows":[{"certified":true,"date":"2028-07-01","end":"11:06","kind":"window","nakshatra":"Swati","rank":1,"score":78.9,"start":"09:06","tithi":"Shukla 10","vara":"Saturday","verdict":"Certified (>=70)"},{"certified":true,"date":"2028-05-10","end":"14:23","kind":"window","nakshatra":"Anuradha","rank":2,"score":78.1,"start":"12:23","tithi":"Krishna 2","vara":"Thursday","verdict":"Certified (>=70)"},{"certified":false,"date":"2028-06-08","end":"13:32","kind":"window","nakshatra":"Mula","rank":3,"score":70.3,"start":"11:32","tithi":"Krishna 2","vara":"Thursday","verdict":"Best available"},{"certified":false,"date":"2028-01-16","end":"14:14","kind":"window","nakshatra":"Uttara Phalguni","rank":4,"score":46.6,"start":"12:14","tithi":"Krishna 5","vara":"Monday","verdict":"Best available"},{"certified":false,"date":"2028-02-20","end":"11:35","kind":"window","nakshatra":"Mula","rank":5,"score":30.5,"start":"09:35","tithi":"Krishna 11","vara":"Sunday","verdict":"Best available"}],"units":25,"request_id":"req_YGpX8ZhMN5"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"boy":{"type":"object","description":"Birth details of the groom. An object with datetime, lat, lon and tz, the same as the birth fields.","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]}},"required":["datetime","lat","lon","tz"],"examples":[{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata"}]},"girl":{"type":"object","description":"Birth details of the bride. An object with datetime, lat, lon and tz, the same as the birth fields.","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]}},"required":["datetime","lat","lon","tz"],"examples":[{"datetime":"1991-12-02T14:40","lat":19.076,"lon":72.8777,"tz":"Asia/Kolkata"}]},"from":{"type":"string","description":"Start date, YYYY-MM-DD.","examples":["2028-01-01"]},"to":{"type":"string","description":"End date, up to 366 days from the start.","examples":["2028-12-31"]},"lat":{"type":"number","description":"Latitude of the wedding place. Or send a place object with lat, lon and tz.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the wedding place.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"best_available":{"type":"boolean","description":"When no day passes every check, return the days that miss one weak point, each with the trade-off named. Default true."}},"required":["boy","girl","from","to","lat","lon","tz"]},"example":{"boy":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata"},"girl":{"datetime":"1991-12-02T14:40","lat":19.076,"lon":72.8777,"tz":"Asia/Kolkata"},"from":"2028-01-01","to":"2028-12-31","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/muhurta/childbirth":{"post":{"operationId":"muhurta-childbirth","summary":"Childbirth muhurta","description":"The best delivery windows in a date range, with the trade-offs named. The hospital place is required. A call takes one to two minutes, so set your client timeout to 3 minutes. Counts as 30 API calls.","tags":["Muhurta"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"best_available":true,"child_dasha":[{"from_age":0,"lord":"Ketu","lord_house":3,"rules":[],"to_age":5.1},{"from_age":5.1,"lord":"Venus","lord_house":8,"rules":[1,6],"to_age":25.1},{"from_age":25.1,"lord":"Sun","lord_house":9,"rules":[4],"to_age":31.1},"... 7 items in all"],"child_domains":{"career":{"house_10":{"house":10,"lord":"Saturn","lord_house":11,"lord_status":"Enemy","occupants":["Mercury"],"sign":"Aquarius"},"significators":[{"house":9,"planet":"Sun","sign":"Capricorn","status":"Neutral"},{"house":11,"planet":"Saturn","sign":"Pisces","status":"Enemy"},{"house":10,"planet":"Mercury","sign":"Aquarius","status":"Friend"}]},"education":{"house_4":{"house":4,"lord":"Sun","lord_house":9,"lord_status":"Neutral","occupants":["Mars"],"sign":"Leo"},"house_5":{"house":5,"lord":"Mercury","lord_house":10,"lord_status":"Friend","occupants":[],"sign":"Virgo"},"jupiter":{"house":3,"planet":"Jupiter","sign":"Cancer","status":"Exalted"},"mercury":{"house":10,"planet":"Mercury","sign":"Aquarius","status":"Friend"}},"health":{"house_6":{"house":6,"lord":"Venus","lord_house":8,"lord_status":"Enemy","occupants":[],"sign":"Libra"},"lagna":{"house":1,"lord":"Venus","lord_house":8,"lord_status":"Enemy","occupants":[],"sign":"Taurus"}},"marriage":{"house_7":{"house":7,"lord":"Mars","lord_house":4,"lord_status":"Neutral","occupants":[],"sign":"Scorpio"},"jupiter":{"house":3,"planet":"Jupiter","sign":"Cancer","status":"Exalted"},"venus":{"house":8,"planet":"Venus","sign":"Sagittarius","status":"Enemy"}},"personality":{"lagna":{"house":1,"lord":"Venus","lord_house":8,"lord_status":"Enemy","occupants":[],"sign":"Taurus"},"moon":{"house":12,"planet":"Moon","sign":"Aries","status":"Enemy"},"sun":{"house":9,"planet":"Sun","sign":"Capricorn","status":"Neutral"}},"wealth":{"house_11":{"house":11,"lord":"Jupiter","lord_house":3,"lord_status":"Exalted","occupants":["Saturn"],"sign":"Pisces"},"house_2":{"house":2,"lord":"Mercury","lord_house":10,"lord_status":"Friend","occupants":[],"sign":"Gemini"},"jupiter":{"house":3,"planet":"Jupiter","sign":"Cancer","status":"Exalted"}}},"father":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"from":"2027-02-10","lang":"en","mother":{"datetime":"1991-12-02T14:40","lat":19.076,"lon":72.8777,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"note":"Astrological timing only. The delivery time is always the doctor's decision.","text_lang":"en","to":"2027-02-14","trade_offs":["Grahan yoga rules out most of this range, so these windows accept it. They are the best available, not ideal.","Guru Chandal rules out most of this range, so these windows accept it. They are the best available, not ideal."],"vetoes":[{"code":"V-D07","count":90,"label":"Grahan yoga"},{"code":"V-D12","count":90,"label":"Guru Chandal"},{"code":"V-D01","count":36,"label":"Vadha tara from a parent"},"... 6 items in all"],"windows":[{"dignities":{"Jupiter":"exalted","Mars":"neutral","Mercury":"friend","Moon":"enemy","Saturn":"enemy","Sun":"neutral","Venus":"enemy"},"lagna":"Taurus","moon":{"dignity":"enemy","sign":"Aries"},"panchanga":{"nakshatra":"Ashwini","pada":2,"paksha":"Shukla","tithi":6,"yoga":"Shubha"},"positions":[{"dignity":"neutral","house":9,"planet":"Sun","sign":"Capricorn"},{"dignity":"enemy","house":12,"planet":"Moon","sign":"Aries"},{"dignity":"neutral","house":4,"planet":"Mars","sign":"Leo"},"... 9 items in all"],"rank":1,"score":29.7,"soft_flags":[{"code":"S-D07","flag":"three or more planets in enemy signs","penalty":3},{"code":"V-D07","flag":"Grahan yoga (accepted: best available)","penalty":8},{"code":"V-D12","flag":"Guru Chandal (accepted: best available)","penalty":8},{"code":"S-H01","flag":"Moon in the 6th or 12th house","penalty":3}],"when":"2027-02-12 12:30","window":["12:18","12:42",24]},{"dignities":{"Jupiter":"exalted","Mars":"neutral","Mercury":"friend","Moon":"enemy","Saturn":"enemy","Sun":"neutral","Venus":"enemy"},"lagna":"Gemini","moon":{"dignity":"enemy","sign":"Pisces"},"panchanga":{"nakshatra":"Uttara Bhadrapada","pada":2,"paksha":"Shukla","tithi":4,"yoga":"Siddha"},"positions":[{"dignity":"neutral","house":8,"planet":"Sun","sign":"Capricorn"},{"dignity":"enemy","house":10,"planet":"Moon","sign":"Pisces"},{"dignity":"neutral","house":3,"planet":"Mars","sign":"Leo"},"... 9 items in all"],"rank":2,"score":26.8,"soft_flags":[{"code":"S-D01","flag":"Shashtashtaka","penalty":6},{"code":"S-D01","flag":"Shashtashtaka","penalty":6},{"code":"S-D07","flag":"three or more planets in enemy signs","penalty":3},"... 6 items in all"],"when":"2027-02-10 13:52","window":["13:46","14:04",18]},{"dignities":{"Jupiter":"exalted","Mars":"neutral","Mercury":"friend","Moon":"enemy","Saturn":"enemy","Sun":"neutral","Venus":"enemy"},"lagna":"Taurus","moon":{"dignity":"enemy","sign":"Pisces"},"panchanga":{"nakshatra":"Uttara Bhadrapada","pada":2,"paksha":"Shukla","tithi":4,"yoga":"Siddha"},"positions":[{"dignity":"neutral","house":9,"planet":"Sun","sign":"Capricorn"},{"dignity":"enemy","house":11,"planet":"Moon","sign":"Pisces"},{"dignity":"neutral","house":4,"planet":"Mars","sign":"Leo"},"... 9 items in all"],"rank":3,"score":18.9,"soft_flags":[{"code":"S-D01","flag":"Shashtashtaka","penalty":6},{"code":"S-D01","flag":"Shashtashtaka","penalty":6},{"code":"S-D07","flag":"three or more planets in enemy signs","penalty":3},{"code":"V-D07","flag":"Grahan yoga (accepted: best available)","penalty":8},{"code":"V-D12","flag":"Guru Chandal (accepted: best available)","penalty":8}],"when":"2027-02-10 12:00","window":["11:49","12:12",23]},{"dignities":{"Jupiter":"exalted","Mars":"neutral","Mercury":"friend","Moon":"enemy","Saturn":"enemy","Sun":"neutral","Venus":"enemy"},"lagna":"Aries","moon":{"dignity":"enemy","sign":"Pisces"},"panchanga":{"nakshatra":"Uttara Bhadrapada","pada":2,"paksha":"Shukla","tithi":4,"yoga":"Siddha"},"positions":[{"dignity":"neutral","house":10,"planet":"Sun","sign":"Capricorn"},{"dignity":"enemy","house":12,"planet":"Moon","sign":"Pisces"},{"dignity":"neutral","house":5,"planet":"Mars","sign":"Leo"},"... 9 items in all"],"rank":4,"score":9.3,"soft_flags":[{"code":"S-D01","flag":"Shashtashtaka","penalty":6},{"code":"S-D01","flag":"Shashtashtaka","penalty":6},{"code":"S-D07","flag":"three or more planets in enemy signs","penalty":3},"... 7 items in all"],"when":"2027-02-10 10:30","window":["10:20","10:42",22]}],"units":30,"request_id":"req_BC5RsxU7dm"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mother":{"type":"object","description":"Birth details of the mother. An object with datetime, lat, lon and tz, the same as the birth fields.","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]}},"required":["datetime","lat","lon","tz"],"examples":[{"datetime":"1991-12-02T14:40","lat":19.076,"lon":72.8777,"tz":"Asia/Kolkata"}]},"father":{"type":"object","description":"Birth details of the father. An object with datetime, lat, lon and tz, the same as the birth fields.","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]}},"required":["datetime","lat","lon","tz"],"examples":[{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata"}]},"from":{"type":"string","description":"First possible delivery date, YYYY-MM-DD.","examples":["2027-02-10"]},"to":{"type":"string","description":"Last possible delivery date, up to 31 days from the first.","examples":["2027-02-14"]},"lat":{"type":"number","description":"Latitude of the hospital. Or send a place object with lat, lon and tz.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the hospital.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"best_available":{"type":"boolean","description":"When no time passes every check, return the best times with the trade-offs named. Default true.","examples":[true]},"office_hours":{"type":"array","description":"Hospital hours as [start, end] in 24-hour clock, for windows_office. Default [9, 18].","items":{"type":"integer"}}},"required":["mother","father","from","to","lat","lon","tz"]},"example":{"mother":{"datetime":"1991-12-02T14:40","lat":19.076,"lon":72.8777,"tz":"Asia/Kolkata"},"father":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata"},"from":"2027-02-10","to":"2027-02-14","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en","best_available":true}}}}}},"/horoscope/daily":{"post":{"operationId":"horoscope-daily","summary":"Daily horoscope","description":"A per-chart daily reading from real panchang, ashtakavarga and tarabala, with a rating, best and avoid times and lucky items. No LLM. Counts as 1 API call.","tags":["Horoscope"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"avoid_time":{"end":"14:46:19","start":"13:26:21"},"based_on":["tarabala","chandrabala","ashtakavarga","panchang","vimshottari"],"best_time":{"end":"12:27:42","start":"11:45:03"},"birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"chandrashtama":false,"date":"2026-11-19","lang":"en","lucky":{"colours":["yellow","gold","cream"],"number":3},"method":"Rules, no LLM: the same chart and date always give the same text.","moon_house_from_moon_sign":5,"moon_sign":"Libra","rating":"Mixed","sarvashtakavarga_points":30,"score":50,"stars":3,"tara":"Janma","text":"The Moon is in the 5th house from your Moon sign. Ideas come easily, but don't gamble on them yet. Today's tara is Janma, your birth star returning. Stay calm and avoid new beginnings. This part of your chart is strong in ashtakavarga, so the Moon's results come through well. Best time: Abhijit 11:45–12:27. Avoid Rahu Kaal 13:26–14:46. Your running period is Mercury mahadasha with Rahu antardasha.","transit_moon_sign":"Aquarius","units":1,"request_id":"req_VFe3VXoSGY"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]},"date":{"type":"string","description":"Day to read, YYYY-MM-DD. Default today at the birth place.","examples":["2026-11-19"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en","date":"2026-11-19"}}}}}},"/remedies/gem":{"post":{"operationId":"remedies-gem","summary":"Gemstone","description":"Gemstone, lucky numbers, colours and name letters for a chart, with the basis for each. Counts as 1 API call.","tags":["Remedies"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"basis":"Lord of the Moon's nakshatra","birth":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","utc_offset_hours":5.5},"gem":"yellow sapphire","gem_id":"yellow sapphire","lang":"en","lucky_colours":["yellow","gold","cream"],"lucky_number":3,"name_letters":["D","H","J"],"planet":"Jupiter","planet_id":"Jupiter","text_lang":"en","units":1,"request_id":"req_odiDYUS89k"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.","examples":["1990-10-21T00:45"]},"lat":{"type":"number","description":"Latitude of the birth place, -90 to 90.","examples":[28.6139]},"lon":{"type":"number","description":"Longitude of the birth place, -180 to 180.","examples":[77.209]},"tz":{"type":"string","description":"IANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.","examples":["Asia/Kolkata"]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.","examples":["en"]},"ayanamsa":{"type":"string","description":"Ayanamsa. Lahiri (chitrapaksha) is the only one today and the default. Any other value gets 400 unsupported_ayanamsa.","enum":["lahiri"]}},"required":["datetime","lat","lon","tz"]},"example":{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata","lang":"en"}}}}}},"/tarot/draw":{"post":{"operationId":"tarot-draw","summary":"Tarot draw","description":"Cards from the 78-card deck, upright or reversed, with our written meanings and a reading, in any of the 12 languages. Counts as 1 API call.","tags":["Tarot"],"parameters":[{"$ref":"#/components/parameters/X-End-User"}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"cards":[{"id":"cups-06","label":"Six of Cups","meaning":"Something from before is offering you real comfort","name":"Six of Cups","position":"past","reversed":false,"step":"Ask what the memory is doing for you now","suit":"cups"},{"id":"swords-10","label":"Ten of Swords","meaning":"It has bottomed out, and there is nothing further to brace for","name":"Ten of Swords","position":"present","reversed":false,"step":"Name one thing that is already over","suit":"swords"},{"id":"cups-03","label":"Three of Cups","meaning":"You are held by people who actually know you","name":"Three of Cups","position":"future","reversed":false,"step":"Name who you could call without preparing first","suit":"cups"}],"deck":78,"lang":"en","method":"Written meanings, no LLM.","reading":{"past":"Behind this sits Six of Cups. In plain terms, something from before is offering you real comfort. It is the condition the present was built on, for better or worse.","present":"The middle of the spread is Ten of Swords. As things stand, it has bottomed out, and there is nothing further to brace for. It follows directly from the six of cups behind it.","future":"Left as it stands, this moves toward Three of Cups, where you are held by people who actually know you. That is a direction and not a fixed event, and it follows from the ten of swords.","summary":"Taken together, Six of Cups, Ten of Swords and Three of Cups describe one movement rather than three separate signs: what you were standing on, what you are holding now, and where it points if nothing shifts. The thread running through it is that the position you are in was arrived at, not handed to you. One concrete step: name who you could call without preparing first."},"seeded":true,"spread":"three_card","units":1,"request_id":"req_C9uJokw7PY"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"spread":{"type":"string","description":"Spread. Default three_card.","enum":["single","three_card"],"examples":["three_card"]},"seed":{"type":"integer","description":"Optional. The same seed always draws the same cards.","examples":[7]},"lang":{"type":"string","description":"Language of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en. Other languages add position_label to each card.","examples":["en"]}},"required":[]},"example":{"spread":"three_card","seed":7,"lang":"en"}}}}}},"/places/search":{"get":{"operationId":"places-search","summary":"Place search","description":"Type a city, town or village and get its latitude, longitude and time zone, ready to send to every chart endpoint. Worldwide, with one country ranked first. Counts as 1 API call.","tags":["Places"],"parameters":[{"$ref":"#/components/parameters/X-End-User"},{"name":"q","in":"query","required":true,"description":"Place name, 3 to 100 characters. Add the state or country to narrow it.","schema":{"type":"string","description":"Place name, 3 to 100 characters. Add the state or country to narrow it.","examples":["Hyderabad"]}},{"name":"country","in":"query","required":false,"description":"Two-letter code of the country to rank first. Other countries still show. Default in.","schema":{"type":"string","description":"Two-letter code of the country to rank first. Other countries still show. Default in.","examples":["in"]}},{"name":"limit","in":"query","required":false,"description":"How many places, 1 to 10. Default 5.","schema":{"type":"integer","description":"How many places, 1 to 10. Default 5.","examples":[3]}}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"attribution":"Powered by Geoapify (https://www.geoapify.com/). Data © OpenStreetMap contributors.","count":3,"country":"IN","places":[{"country":"India","country_code":"IN","formatted":"Hyderabad, TG, India","lat":17.360589,"lon":78.4740613,"name":"Hyderabad","state":"Telangana","type":"city","tz":"Asia/Kolkata"},{"country":"India","country_code":"IN","formatted":"Hyderabad, India","lat":17.388786,"lon":78.4610647,"name":"Hyderabad","state":"Telangana","type":"county","tz":"Asia/Kolkata"},{"country":"Pakistan","country_code":"PK","formatted":"Hyderabad, SD, Pakistan","lat":25.3868287,"lon":68.3714971,"name":"Hyderabad","state":"Sindh","type":"city","tz":"Asia/Karachi"}],"query":"Hyderabad","units":1,"request_id":"req_TMX3DevEAP"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"502":{"description":"The engine could not answer: engine_unavailable or engine_error. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/logs":{"get":{"operationId":"logs","summary":"Request logs","description":"Your own request log, newest first, filterable by end-user tag, endpoint and time. Rows are kept for at least 30 days. Free to call. Free to call.","tags":["Account"],"parameters":[{"$ref":"#/components/parameters/X-End-User"},{"name":"end_user","in":"query","required":false,"description":"Only calls with this X-End-User tag.","schema":{"type":"string","description":"Only calls with this X-End-User tag.","examples":["user_8f2c"]}},{"name":"endpoint","in":"query","required":false,"description":"Only calls to this path, such as /v1/panchang.","schema":{"type":"string","description":"Only calls to this path, such as /v1/panchang."}},{"name":"since","in":"query","required":false,"description":"Only calls at or after this time, ISO 8601 with a zone: 2026-11-18T00:00:00Z.","schema":{"type":"string","description":"Only calls at or after this time, ISO 8601 with a zone: 2026-11-18T00:00:00Z."}},{"name":"limit","in":"query","required":false,"description":"Rows a page, 1 to 1,000. Default 1,000.","schema":{"type":"integer","description":"Rows a page, 1 to 1,000. Default 1,000.","examples":[3]}},{"name":"cursor","in":"query","required":false,"description":"next_cursor from the previous page.","schema":{"type":"string","description":"next_cursor from the previous page."}}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"data":[{"end_user":"user_8f2c","endpoint":"/v1/usage","method":"GET","ms":5,"request_id":"req_sN5Ha8k8KF","status":200,"time":"2026-11-22T16:18:25Z","units":0},{"end_user":"user_8f2c","endpoint":"/v1/places/search","method":"GET","ms":1586,"request_id":"req_TMX3DevEAP","status":200,"time":"2026-11-22T16:18:25Z","units":1},{"end_user":"user_8f2c","endpoint":"/v1/tarot/draw","method":"POST","ms":12,"request_id":"req_C9uJokw7PY","status":200,"time":"2026-11-22T16:18:23Z","units":1}],"next_cursor":"req_C9uJokw7PY","note":"No birth data is stored. Rows are kept 30 days.","units":0,"request_id":"req_vaovWBExQc"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"500":{"description":"The log store could not be read.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/usage":{"get":{"operationId":"usage","summary":"Usage","description":"Your usage for a month, India time: API calls used, requests and errors, by day, by endpoint and by end user. Without end_user it also gives the plan, extra API calls and their cost so far, and your spend cap if set. Free to call. Free to call.","tags":["Account"],"parameters":[{"$ref":"#/components/parameters/X-End-User"},{"name":"month","in":"query","required":false,"description":"Month, YYYY-MM. Default this month.","schema":{"type":"string","description":"Month, YYYY-MM. Default this month.","examples":["2026-11"]}},{"name":"end_user","in":"query","required":false,"description":"Only calls with this X-End-User tag. The plan and cost fields are left out when you send it.","schema":{"type":"string","description":"Only calls with this X-End-User tag. The plan and cost fields are left out when you send it."}}],"responses":{"200":{"description":"OK. The example is the real answer to the example request.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Units":{"$ref":"#/components/headers/X-Units"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["units","request_id"],"properties":{"units":{"type":"integer","description":"How many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints."},"request_id":{"type":"string"}}},"example":{"ai":{"minutes_left":0,"questions_left":0,"trial_questions_left":10},"as_of":"2026-11-22T16:18:25Z","by_day":[{"calls":203,"date":"2026-11-21","errors":47,"units":257},{"calls":292,"date":"2026-11-22","errors":72,"units":488}],"by_end_user":[{"calls":495,"end_user":"user_8f2c","errors":119,"units":745}],"by_endpoint":[{"calls":12,"endpoint":"/v1/muhurta/childbirth","errors":0,"units":135},{"calls":22,"endpoint":"/v1/muhurta/marriage","errors":10,"units":110},{"calls":12,"endpoint":"/v1/chart/pdf","errors":0,"units":60},"... 31 items in all"],"calls":495,"currency":"INR","errors":119,"extra_cost_minor":0,"extra_units":0,"from":"2026-11-01","month":"2026-11","note":"units_used counts API calls from successful requests only. Heavy calls count as 5. Errors are never counted. by_end_user lists the top 100 tags.","plan":{"id":"free","name":"Free","units_included":1000},"timezone":"Asia/Kolkata","to":"2026-11-30","units_used":745,"units":0,"request_id":"req_sN5Ha8k8KF"}}}},"400":{"description":"Invalid input. Not charged.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"invalid_tz","error":"invalid \"tz\": use an IANA zone like Asia/Kolkata or an offset like +05:30","request_id":"req_gQcuMMyJSf"}}}},"401":{"description":"Missing or unknown key.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"unknown_key","error":"missing or unknown API key","request_id":"req_C32NDoJBPT"}}}},"403":{"description":"The key's allow list doesn't include this IP or domain.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"no_such_endpoint","error":"no endpoint POST /v1/transits/ingresses; see the API reference for the list","request_id":"req_8UXUjXtYTD"}}}},"429":{"description":"Over a limit: rate_limited, monthly_limit or spend_cap.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"code":"rate_limited","error":"rate limit: 2 calls a second on this plan. Retry after 1 s","request_id":"req_j75K8uNf6s"}}}},"500":{"description":"The log store could not be read.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"An API key: sk_live_..."}},"parameters":{"X-End-User":{"name":"X-End-User","in":"header","required":false,"description":"Your own id for the end user: up to 64 letters, numbers, _ and -. Shows in request logs. Never personal data.","schema":{"type":"string","maxLength":64,"pattern":"^[A-Za-z0-9_-]{1,64}$"}}},"headers":{"X-Request-Id":{"description":"Id of this call.","schema":{"type":"string"}},"X-Units":{"description":"How many API calls this request counts as. Same as units in the body.","schema":{"type":"integer"}}},"schemas":{"Error":{"type":"object","required":["error","code","request_id"],"properties":{"error":{"type":"string","description":"Readable message. It names the field at fault."},"code":{"type":"string","description":"Stable error code.","enum":["missing_key","unknown_key","not_allowed","no_such_endpoint","invalid_json","invalid_datetime","invalid_tz","invalid_lat","invalid_lon","invalid_date","invalid_time","invalid_as_of","invalid_from","invalid_to","invalid_range","range_too_long","invalid_purpose","invalid_place","invalid_boy","invalid_girl","invalid_mother","invalid_father","invalid_chart","invalid_kind","invalid_style","invalid_format","invalid_sections","invalid_spread","invalid_since","invalid_month","invalid_end_user","unsupported_lang","unsupported_ayanamsa","rate_limited","monthly_limit","spend_cap","internal","engine_unavailable","engine_error"]},"request_id":{"type":"string"}}}}}}