Account REST API
REST endpoints for your charts, techniques, transits and synastry — the same the apps use. Auth: X-API-Key (active paid plan).
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; an active paid plan with Account API access is required. 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.
Active paid plan — The account must be on an active plan with Account API access. (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 require an active paid plan; they do NOT consume AstroCodex tokens. (Only AstroCodex's own in-app AI chat spends tokens, and that is separate from this API.)