VedAstro
Back to Docs

Quickstart

Get your first API response in under 5 minutes.

1

1. Create an account

Sign up at /register. You get 100 free requests/month immediately — no credit card required.

2

2. Get your API key

Go to Dashboard → API Keys and create a new key. Copy it — it's only shown once.

bash
# Your key looks like this
va_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
3

3. Make your first request

Pass your API key in the X-API-Key header.

cURLPythonJavaScript
curl -X POST \
  https://vedic-astrology-production-a045.up.railway.app/api/v1/calculate/chart \
  -H "Content-Type: application/json" \
  -H "X-API-Key: va_live_xxxxxxxxxxxx" \
  -d '{
    "name": "Arjuna",
    "date": "1990-01-15",
    "time": "08:30",
    "location": "Mumbai, India"
  }'
4

4. Handle the response

All responses follow this structure:

json
{
  "status": "pass",
  "payload": {
    "ascendant": "Scorpio",
    "moonSign": "Cancer",
    "sunSign": "Capricorn",
    "planets": [ ... ]
  }
}

Next steps