Appearance

All developer API endpoints require an API key passed in the X-API-Key header.

Getting an API key ​

  1. Sign in to askvedicguru.com
  2. Go to Dashboard → API Keys
  3. Click Create Key, give it a name
  4. Copy the key — it's only shown once

Using the key ​

Add the X-API-Key header to every request:

bash
curl -X POST https://api.askvedicguru.com/api/v1/birth-chart \
  -H "Content-Type: application/json" \
  -H "X-API-Key: avg_xxxxxxxxxxxxxxxxxxxx" \
  -d '{ "profileId": "683abc123def456" }'

Key limits by plan ​

PlanKeys allowedRate limit
Trial (free)15 req/min
Starter ($29/mo)360 req/min
Growth ($99/mo)10120 req/min

Rate limit headers ​

Every response includes rate limit headers:

http
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1716700800

When you exceed the limit you get 429 Too Many Requests:

json
{
  "success": false,
  "error": {
    "message": "Rate limit exceeded. Try again in 12 seconds.",
    "code": "RATE_LIMIT_EXCEEDED"
  }
}

Revoking a key ​

Keys can be revoked from the dashboard or via the API Keys endpoint.