Account REST API
REST endpoints for your charts, techniques, transits and synastry — the same the apps use. Auth: X-API-Key. Available on all plans including Free (with reduced limits).
The Account REST API gives your application programmatic access to a user's saved charts, technique results, transits and synastry — the same endpoints the AstroCodex web and mobile apps use. Authenticate with an Account API key in the X-API-Key header; available on all plans including Free (with reduced limits) — higher plans raise rate and monthly quotas. All responses are JSON. (Want a keyless OAuth sign-in for an AI assistant? Use the Account MCP.)
Authentication
X-API-Key header — Pass your Account API key in the X-API-Key request header.
Plan access — Available on all plans including Free (with reduced limits); higher plans raise rate and monthly quotas. (Prefer signing in without a key? OAuth is available on the Account MCP surface.)
Base URL
https://api.astrocodex.aiKey endpoints
/api/meThe authenticated user's profile and current plan./api/natal-chartsList the user's saved natal charts./api/natal-chartsCreate a new chart and compute it./api/natal-charts/{publicId}Read one chart by its public id — full computed data plus the technique registry./api/natal-charts/{publicId}Update a chart's name or birth data and recompute it./api/natal-charts/{publicId}Delete one of the user's charts./api/natal-charts/{publicId}/transitsCurrent or date-specific transits for a saved chart./api/synastry/calculateCompute synastry / compatibility between two charts.A core selection — the same routes the AstroCodex apps use. Reading one chart (GET …/{publicId}) returns its full computed data — planets, houses and the whole registry of natal techniques. The same /api base also exposes chart recalculation, AI overviews, public sharing and full synastry management.
Account REST calls are metered as requests and are available on all plans including Free (higher plans raise rate and monthly quotas); they do NOT consume AstroCodex tokens. (Only AstroCodex's own in-app AI chat spends tokens, and that is separate from this API.)