Quickstart

Every request carries your key in the X-API-Key header. There is no handshake, no token exchange and nothing to sign.

1. Get a key

Create a free account and a sandbox key is issued immediately — 100 credits a month, no card. Your keys live on the API keys page, where you can rename, revoke or issue more at any time.

Verify your email to unlock live keys and credit purchases. Until then, test keys work against the full sandbox.

2. Create a birth record

Most endpoints work from a saved chart, so create one first. Note the field names — they are date_of_birth and time_of_birth, not birth_date:

curl https://rajvidya.com/api/v1/charts/ \
  -X POST \
  -H "X-API-Key: rv_test_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Test Person",
    "date_of_birth": "1990-05-15",
    "time_of_birth": "14:30",
    "place_of_birth": "Pune, India",
    "latitude": 18.52,
    "longitude": 73.85,
    "timezone_offset": 5.5
  }'

The response carries the id you pass to everything else:

{"id": 2317, "name": "Test Person", "is_calculated": true}

3. Call an engine

curl https://rajvidya.com/api/v1/kundli/ \
  -H "X-API-Key: rv_test_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxx" \
  -G --data-urlencode "chart_id=2317"

A few endpoints need no chart at all — /api/v1/rashifal/ takes a sign, and /api/v1/prashna/ takes a location and a question.

4. Read your usage

Every response carries X-Credits-Charged and X-Quota-Remaining. For the full picture call /api/v1/usage/ — it is never billed and keeps working even after your quota is spent.

5. Switch language

Add lang to any request. This selects written interpretation text, not machine translation.

curl https://rajvidya.com/api/v1/rashifal/ \
  -H "X-API-Key: YOUR_KEY" -G --data-urlencode "lang=ta"