Documentation content is currently available in English.
Back to Docs

Authentication

How to authenticate your API requests.

API Key Authentication

All API requests must include your API key in the X-API-Key header.

curl -X POST https://astroapi.vedicmatters.com/api/v1/chart/birth \
  -H "X-API-Key: va_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"dateTime":"1990-01-15T08:30:00","location":{"name":"Mumbai, India","latitude":19.076,"longitude":72.8777}}'

Rate Limits

PlanRequests / MonthRequests / Minute
Free10010
Starter5,000100
Professional50,000500
EnterpriseUnlimitedUnlimited

Rate Limit Headers

Every response includes headers to track your usage:

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4823
X-RateLimit-Reset: 1706745600

Error Responses

CodeMeaning
401Missing or invalid API key
403Subscription required or suspended
429Rate limit exceeded
500Server error — contact support