Childbirth muhurta
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.
https://api.vedicapi.co/v1/muhurta/childbirthHeavy call: it does more work, so it counts as 30 API calls on your plan. How API calls are counted
Authentication
Send your API key as a Bearer token. Keys start with sk_live_. Keep keys on your server. More on keys
Authorization: Bearer $VEDICAPI_KEY
Headers
AuthorizationRequiredrequiredDescriptionBearer followed by your API key.X-End-UserRequiredoptionalDescriptionYour own id for the person the call is for, up to 64 characters. Shows in Request logs. End-user tagsContent-TypeRequiredrequiredDescriptionapplication/json
Body parameters
motherobjectrequiredBirth details of the mother. An object with datetime, lat, lon and tz, the same as the birth fields.
Example{"datetime":"1991-12-02T14:40","lat":19.076,"lon":72.8777,"tz":"Asia/Kolkata"}datetimestringrequiredLocal birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.
latnumberrequiredLatitude of the birth place, -90 to 90.
lonnumberrequiredLongitude of the birth place, -180 to 180.
tzstringrequiredIANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.
fatherobjectrequiredBirth details of the father. An object with datetime, lat, lon and tz, the same as the birth fields.
Example{"datetime":"1990-10-21T00:45","lat":28.6139,"lon":77.209,"tz":"Asia/Kolkata"}datetimestringrequiredLocal birth time, ISO 8601 with no offset: 1990-10-21T00:45. Seconds are optional.
latnumberrequiredLatitude of the birth place, -90 to 90.
lonnumberrequiredLongitude of the birth place, -180 to 180.
tzstringrequiredIANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.
fromstringrequiredFirst possible delivery date, YYYY-MM-DD.
Example2027-02-10tostringrequiredLast possible delivery date, up to 31 days from the first.
Example2027-02-14latnumberrequiredLatitude of the hospital. Or send a place object with lat, lon and tz.
Example28.6139lonnumberrequiredLongitude of the hospital.
Example77.209tzstringrequiredIANA zone (Asia/Kolkata) or an offset (+05:30). Past rule changes and daylight saving are handled.
ExampleAsia/KolkatalangstringLanguage of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.
Exampleenbest_availablebooleanWhen no time passes every check, return the best times with the trade-offs named. Default true.
Exampletrueoffice_hoursarray of integerHospital hours as [start, end] in 24-hour clock, for windows_office. Default [9, 18].
Response
JSON with 200 OK. Every answer carries units (how many API calls this request counts as) and request_id, and the same values in the X-Units and X-Request-Id headers. The example belowon the right is the real answer to the request shown.
best_availablebooleanTrue when no time passed every check and these are the best available.child_dashaarrayThe child's first maha dasha periods by age.child_domainsobjectThe child's chart by life area.fatherobjectFather's birth as you sent it.fromstringStart of the range.langstringLanguage of names and labels.motherobjectMother's birth as you sent it.notestringA short note on how to read the answer.text_langstringLanguage of the longer text. English for now.tostringEnd of the range.trade_offsarrayWhat the best-available windows accept, in plain words.vetoesarrayEvery check that ruled out times, with its code, label and how many times it ruled out.windowsarrayRanked time windows, best first.unitsnumberHow many API calls this request counts as: 1, or 5 for a heavy call; 0 for errors and free endpoints.request_idstringId of this call. Search it in Request logs. Also sent as the X-Request-Id header.
Errors
- 400Codes
invalid_jsoninvalid_motherinvalid_fatherinvalid_placeinvalid_latinvalid_loninvalid_tzinvalid_frominvalid_toinvalid_rangerange_too_longunsupported_langinvalid_end_userWhenA field is missing or invalid. The message names the field. - 401Codes
missing_keyunknown_keyWhenNo key, or the key is wrong, revoked or past its rotation window. - 403Codes
not_allowedWhenThe key has an allow list and this call came from another IP or domain. - 404Codes
no_such_endpointWhenWrong path or method. - 429Codes
rate_limitedmonthly_limitspend_capWhenOver a limit. Wait the Retry-After seconds before trying again. - 503Codes
busyWhenLong searches are busy. Wait the Retry-After seconds and retry. Nothing is counted. - 502Codes
engine_unavailableengine_errorWhenOur engine could not answer. Retry with backoff.
Errors are never charged. Every error has one shape: { "error": "<message>", "code": "<code>", "request_id": "req_..." }. Errors and limits