Developers / Getting started / Quickstart

Quickstart

Make your first authenticated call in about two minutes.

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. Call an endpoint

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

3. 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.

4. 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"

Last updated 13 August 2026.