Documentation content is currently available in English.
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://astroapi.vedicmatters.com/api/v1/chart/birth \
  -H "Content-Type: application/json" \
  -H "X-API-Key: va_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "dateTime": "1990-01-15T08:30:00",
    "location": {
      "name": "Delhi, India",
      "latitude": 28.6139,
      "longitude": 77.209
    },
    "ayanamsa": "LAHIRI"
  }'
4

4. Handle the response

All responses follow this structure:

json
{
  "success": true,
  "data": {
    "dateTime": "1990-01-15T08:30:00+05:30",
    "location": {
      "name": "Delhi, India",
      "latitude": 28.6139,
      "longitude": 77.209
    },
    "ayanamsa": "LAHIRI",
    "planets": {},
    "houses": {},
    "ascendant": {}
  },
  "timestamp": "2026-06-18T10:30:00.000Z"
}