Ashtakoot matching
Guna milan out of 36: each of the 8 kootas, a one-word verdict, and the Nadi and Bhakoot dosha checks.
https://api.vedicapi.co/v1/match/ashtakootAuthentication
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
boyobjectrequiredBirth details of the first person. 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.
girlobjectrequiredBirth details of the second person. 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.
langstringLanguage of names and labels: en, hi, mr, bn, te, gu, ta, pa, kn, ml, en_IN (Hinglish) or de. Default en.
Exampleen
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.
boyobjectFirst person's birth as you sent it.doshasobjectNadi and Bhakoot dosha present or not.girlobjectSecond person's birth as you sent it.kootasarrayThe 8 kootas: points got and max, and each person's attribute.langstringLanguage of names and labels.maxnumberMaximum points.notestringA short note on how to read the answer.totalnumberTotal points.verdictstringOne word: Excellent, Good, Average or Not recommended.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_boyinvalid_girlunsupported_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. - 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