API Reference

Reference for every endpoint.

Generated from the same Zod schemas the engine validates against - what you read here is what the API accepts. Every endpoint includes the request shape, response envelope, and a runnable curl example.

Get an API keyTry in playgroundDownload OpenAPI spec ↗

Start here

1. Authenticate

Bearer-token auth with aie_test_* / aie_live_* key prefixes. Mint keys from the dashboard.

2. Request envelope

Most endpoints accept a small birth-input - date, time, tz_offset_minutes, lat, lng.

3. Response envelope

Every response returns request_id, data, and meta - plus an optional interpretation block on narrative endpoints.

4. Rate limits

Per-plan sliding window + monthly quota. Responses include x-ratelimit-* headers; 429s use RATE_LIMITED or QUOTA_EXCEEDED.

All endpoints

110 endpoints across 11 traditions

Every public route, grouped by engine. Each links to its own page with the request fields, types and constraints generated from this same OpenAPI document. The interactive reference is below.

Vedic 43

Nadi 4

KP 7

Lal Kitab 5

Numerology 7

Western 24

Tarot 4

Remedies 3

Compatibility 6

Reports 3

AI Astrologer 4