/v1/meta/endpoints

Full endpoint catalog.

What this tells you

The live endpoint catalog: every route with its group, credit cost and auth tier. Machine-readable and always in step with the running server.

Request

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

example request

curl "https://api.lifeastroapi.com/v1/meta/endpoints?" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (200 OK)

The real response to the example request above, generated from the API itself. Long arrays are trimmed to their first two items. Field names are stable across versions.

200 response

{
  "routes": [
    {
      "path": "/healthz",
      "method": "GET",
      "group": "health",
      "cost": 0,
      "auth": "public"
    },
    {
      "path": "/readyz",
      "method": "GET",
      "group": "health",
      "cost": 0,
      "auth": "public"
    }
  ],
  "total_routes": 314,
  "milestone": 1
}

Field reference

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

Field	Type	Meaning
routes[]	array	Every registered route, including /healthz and /readyz. example: `[…]`
routes[].path	string	Route path. example: `"/healthz"`
routes[].method	string	HTTP method. example: `"GET"`
routes[].group	string	Logical group (health, meta, panchang, chart, dasha, …). example: `"health"`
routes[].cost	integer	Credits charged per call, from the live billing cost table. 0 = free. example: `0`
routes[].auth	string	"public" (no API key needed) or "bearer" (needs an API key). example: `"public"`
total_routes	integer	Number of entries in `routes`. example: `314`
milestone	integer	Internal release marker. Ignore it. example: `1`

Usage tips

How to use it

Build-time fetch
If you are building your own docs or admin UI, fetch this at build time to reflect the live API.
Show prices before a call
Use `routes[].cost` to tell users what a call will cost.
Free endpoint
Costs 0 credits and needs no API key.

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://lifeastroapi.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 1,500 free credits. Sign up.