Ratnoveda

Quick start

Make your first API call in three steps.

Full API reference (OpenAPI)

1 · Create an account

Sign up — you get an organization, a default project and 100 credits.

2 · Generate an API key

In Dashboard → API keys create a test key (free, lower rate limits) or a live key (consumes credits). The full key is shown once — store it in an environment variable on your server, never in browser or mobile code.

3 · Call the Kundli API

Send the key as X-API-Key (or Authorization: Bearer). Use an IANA timezone such as Asia/Kolkata; omit it to resolve from the coordinates.

curl -X POST 'https://astrologyapis.ratnoveda.com/v1/vedic/kundli' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "Test User", "date": "1990-05-10", "time": "19:55", "latitude": 28.6139, "longitude": 77.2090, "timezone": "Asia/Kolkata" }'

Response format

{
  "status": true,
  "data": { "birth_details": {…}, "ascendant": {…}, "planets": [...],
            "houses": [...], "charts": { "D1": {…}, "D9": {…} },
            "dasha": { "vimshottari": {…} } },
  "meta": { "request_id": "req_…", "calculation_version": "1.0.0",
            "cached": false, "credits_charged": 5 }
}

Errors

401AUTHENTICATION_REQUIRED / INVALID_API_KEYMissing, wrong, revoked or expired key
402INSUFFICIENT_CREDITSWallet balance below the endpoint's credit cost
422VALIDATION_ERRORBad field (e.g. latitude out of range, numeric timezone)
422NONEXISTENT_LOCAL_TIME / AMBIGUOUS_LOCAL_TIMETime skipped or repeated by a DST change; send ambiguous_time
422DATE_OUT_OF_RANGEDates must be between 1800 and 2399
429RATE_LIMIT_EXCEEDEDToo many requests; wait for Retry-After seconds
503ENDPOINT_DISABLEDEndpoint temporarily switched off