/v1/meta/endpoints

Full endpoint catalog.

What this tells you

The full live endpoint catalog — machine-readable, always up to date. Used by the website to auto-generate documentation at build time.

Request

All requests require an Authorization header with your dv_live_* API key.

example request

curl "https://api.divyastroapi.com/v1/meta/endpoints?date=2026-04-19&time=06%3A30&tz=%2B05%3A30&lat=28.61&lon=77.21" \
  -H "Authorization: Bearer dv_live_0123456789abcdef0123456789abcdef"

Response (200 OK)

Successful requests return a JSON body. Field names are stable across versions.

200 response

[
  { "method": "GET", "path": "/v1/panchang/tithi",     "group": "panchang", "cost": 1, "summary": "Lunar day (tithi) at moment" },
  { "method": "GET", "path": "/v1/panchang/nakshatra", "group": "panchang", "cost": 1, "summary": "Nakshatra + pada + lord" },
  { "method": "GET", "path": "/v1/chart/planets",      "group": "chart",    "cost": 1, "summary": "All 9 planets + ascendant" }
]

Field reference

Every field in the response, with its type, a real example, and what it means.

Field	Type	Meaning
[].method	string	HTTP method. example: `"GET"`
[].path	string	Endpoint path. example: `"/v1/panchang/tithi"`
[].group	string	Logical group (panchang, chart, dasha, milan, etc.). example: `"panchang"`
[].cost	integer	Credit cost per call. example: `1`
[].summary	string	One-line description. example: `"Lunar day (tithi) at moment"`

Usage tips

How to use it

Build-time fetch
If you're building your own docs or admin UI, fetch this at build time to always reflect the live API.
Free endpoint
Costs 0 credits, unauthenticated. Use freely.

Errors

Every error follows the same envelope. Use the error.code field (not the message) for conditional logic in your integration.

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "missing or invalid API key",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

402 Payment Required

{
  "error": {
    "code": "trial_exhausted",
    "message": "your free trial credits are exhausted — pick a plan to continue",
    "top_up_url": "https://divyastroapi.com/pricing",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded; retry after 12 seconds",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

Try it

Get a dv_live_* key from your dashboard and paste into the cURL snippet above. New accounts get 500 free credits. Sign up.