v1 · stable

Astro Research Labs API

The API exposes deterministic astrological calculations as JSON-over-HTTPS. Endpoints accept structured inputs (date, time, location, ayanamsa) and return structured outputs (planetary positions, nakshatras, dashas, transits).

Base URL: https://api.astroresearchlabs.com

Authentication

All requests must include an Authorization header with a bearer token.

bash

curl -H "Authorization: Bearer arl_test_your_key" \
  https://api.astroresearchlabs.com/v1/panchang?date=2026-05-08&tz=Asia/Kolkata

POST /v1/chart

Compute a birth chart from date, time, and coordinates.

json · request

{
  "date": "1994-08-21",
  "time": "14:35:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.2090,
  "ayanamsa": "lahiri",
  "house_system": "whole_sign"
}

json · 200 OK

{
  "lagna":   { "sign": "Virgo", "deg": 14.27 },
  "planets": [
    { "name": "Sun",  "sign": "Leo",     "deg":  4.23, "nakshatra": "Magha",    "pada": 1, "retro": false },
    { "name": "Moon", "sign": "Scorpio", "deg": 12.13, "nakshatra": "Anuradha", "pada": 2, "retro": false }
  ],
  "meta": { "request_id": "req_01HW...", "ms": 38 }
}

GET /v1/panchang

Daily Panchang for a given date and location.

bash

GET /v1/panchang?date=2026-05-08&lat=28.6139&lon=77.2090&tz=Asia/Kolkata

POST /v1/dasha

Vimshottari mahadasha, antardasha, and pratyantardasha sequences.

POST /v1/transits

Forward planetary transits over a date range relative to a natal chart.

Errors

Errors return a standard envelope with HTTP status and a machine-readable code.

json · 4xx

{
  "error": {
    "code": "invalid_coordinates",
    "message": "latitude must be between -90 and 90",
    "request_id": "req_01HW..."
  }
}

Rate limits

See the API page for current limits per tier. Limits are returned in X-RateLimit-* headers.