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.