/v1/meta/version

API version + build commit.

What this tells you

Version and build info. Useful for health dashboards and support diagnostics. Free endpoint.

Request

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

example request

curl "https://api.divyastroapi.com/v1/meta/version?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

{
  "version": "1.0.0",
  "build_commit": "a1b2c3d",
  "swisseph_version": "2.10.03",
  "endpoint_count": 72,
  "uptime_seconds": 1245789
}

Field reference

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

Field	Type	Meaning
version	string	API version — semver. Breaking changes bump major. example: `"1.0.0"`
build_commit	string	Git commit the running binary was built from. example: `"a1b2c3d"`
swisseph_version	string	Version of the Swiss Ephemeris library linked. example: `"2.10.03"`
endpoint_count	integer	Total registered endpoints. example: `72`
uptime_seconds	integer	How long the current server instance has been running. example: `1245789`

Usage tips

How to use it

Health check
Ping this from your uptime monitor — it returns quickly and includes a build commit you can verify.

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.