# The Leo King Business Intelligence API

The Leo King API is a server-to-server business astrology intelligence API for owned chart compute, compatibility, audience intelligence, premium AI experiences, helio StarTypes background lookup, and Beyond The Veil world-signal workflows.

## Primary Documentation

- Human docs: https://theleokingai.com/api-docs
- API product page: https://theleokingai.com/api-platform
- API console: https://theleokingai.com/api-console
- Billing and plan console: https://theleokingai.com/api-console/billing
- API Lab: https://theleokingai.com/api-console/lab
- OpenAPI JSON: https://theleokingai.com/api/v1/openapi
- Endpoint index: https://theleokingai.com/api/v1
- Examples and cookbooks: https://theleokingai.com/api/v1/examples
- Access-control packet: https://theleokingai.com/api/v1/access-control
- Onboarding and launch readiness: https://theleokingai.com/api/v1/onboarding
- Public status: https://theleokingai.com/api/v1/status
- Versioning and limits: https://theleokingai.com/api/v1/versioning
- Changelog: https://theleokingai.com/api/v1/changelog
- Support policy: https://theleokingai.com/api/v1/support
- SDK readiness: https://theleokingai.com/api/v1/sdks
- Migration guides: https://theleokingai.com/api/v1/migrations
- Procurement packet: https://theleokingai.com/api/v1/procurement
- Conformance contract: https://theleokingai.com/api/v1/conformance
- Data-processing packet: https://theleokingai.com/api/v1/data-processing
- Compliance map: https://theleokingai.com/api/v1/compliance
- AI governance: https://theleokingai.com/api/v1/ai-governance
- Webhook contract: https://theleokingai.com/api/v1/webhooks
- Error catalog: https://theleokingai.com/api/v1/errors
- Postman collection: https://theleokingai.com/api/v1/postman
- Full AI-readable docs map: https://theleokingai.com/llms-full.txt

## Integration Rules

- Auth uses the x-api-key header.
- Use Idempotency-Key for retry-safe usage and billing records.
- Use https://theleokingai.com/api/v1/examples for canonical request/response examples and cookbook workflows.
- Use https://theleokingai.com/api/v1/access-control for API-key custody, scopes, environments, lifecycle, browser/CORS policy, and allowlist gates.
- Use https://theleokingai.com/api/v1/onboarding for server-key setup, launch-readiness gates, handoff artifacts, and support packet boundaries.
- Use https://theleokingai.com/api/v1/support for support tiers, escalation rules, and support packet requirements.
- Use https://theleokingai.com/api/v1/sdks for package names, install commands, and SDK release gates.
- Use https://theleokingai.com/api/v1/migrations for legacy alias moves, deprecation artifacts, and route migration validation.
- Use https://theleokingai.com/api/v1/procurement for buyer-review evidence, signed-term gates, and security/legal/ops review boundaries.
- Use https://theleokingai.com/api/v1/conformance for acceptance suites, smoke commands, launch gates, and evidence artifacts.
- Use https://theleokingai.com/api/v1/data-processing for processing purposes, minimization rules, restricted-data boundaries, and DSR support policy.
- Use https://theleokingai.com/api/v1/compliance for framework-style review mapping, current public evidence, no-certification-overclaim policy, and signed-term gates.
- Use https://theleokingai.com/api/v1/ai-governance for acceptable-use boundaries, prohibited and restricted use cases, output-quality controls, human-review requirements, and escalation triggers.
- 429 responses include rate-limit details and standard rate-limit headers when limiter metadata is present.
- Success envelope fields are request_id, data, usage, and meta.
- Error envelope fields are request_id and error.
- Core Compute routes must not call AI models.
- AI routes must preserve output quality; fallback-looking output is a failed response, not success.
- StarTypes is heliocentric tropical background context only, not geocentric natal houses or lead prediction logic.

## Public Endpoint Summary

- POST /v1/audience/insights: Generate customer-level buyer archetypes, campaign fit, timing notes, and message angles from birth data and campaign context.
- POST /v1/experiences/future-partner-vision: Generate a structured future partner profile, relationship scene, attraction pattern, timing window, and optional image prompt from birth data and love context.
- POST /v1/experiences/love-reveal: Generate a high-specificity love reading that can blend psychic interpretation, tarot symbolism, owned astrology context, and 5-7-8 relationship logic.
- POST /v1/experiences/crystal-ball: Generate a cinematic symbolic vision with concrete interpretation, action guidance, and optional image-generation direction.
- POST /v1/oracle/ask: Answer a direct spiritual question through the paid Lady Avalon API path with strict JSON output, usage metering, and no legacy MCP dependency.
- POST /v1/tarot/draw: Draw and interpret tarot spreads from the local 78-card Rider-Waite-Smith corpus with deterministic seed support and paid API metering.
- POST /v1/past-life/reading: Generate an AstraGate-style past-life reading with structured scene, karmic pattern, present-life echo, healing action, and empowerment.
- POST /v1/charts/synastry: Return owned geocentric tropical synastry data and relationship aspect overlays without calling an external astrology API.
- POST /v1/compatibility/score: Score relationship compatibility using synastry, 5-7-8 house activation, love-planet frameworks, and optional StarTypes background comparison.
- POST /v1/charts/natal: Return a geocentric tropical natal chart from the Kerykeion/Swiss sidecar for partners that need raw chart data, not generated interpretation.
- POST /v1/charts/transits: Return geocentric tropical transit positions and aspects from the owned sidecar for timing, daily horoscope, and ephemeris workflows.
- POST /v1/charts/current-sky: Return the owned geocentric tropical current-sky chart for a supplied moment and location without calling external astrology APIs.
- POST /v1/lunar/phase: Return first-party Sun-Moon lunar phase context for a supplied moment and location without horoscope prose or third-party fallback.
- POST /v1/horoscope/daily: Generate personalized daily horoscope output from owned transit substrate, zodiac knowledge, and optional birth profile context.
- POST /v1/timing/windows: Generate practical timing windows for launches, love, career, money, content, and spiritual work using owned transit substrate.
- POST /v1/world/signals: Generate Beyond The Veil style mundane intelligence with deterministic ephemeris context, BTV RAG metadata, and quality controls.
- POST /v1/world/signals/jobs: Create an asynchronous Beyond The Veil world signal forecast job for deep production use, then poll the job URL until the quality-gated forecast is complete.
- POST /v1/mundane/hot-zones: Rank supplied regions as Beyond The Veil style hot zones for a topic and time window using owned transit context and structured generation.
- POST /v1/mundane/analyze-event: Analyze a supplied world event through mundane astrology and return forward-looking implications, analogs, watch windows, and action guidance.
- POST /v1/helio/patterns: Lookup heliocentric tropical StarTypes patterns with attribution to Michael Erlewine's contributions, source work, and interpretations as a background/evaluation signal.
- POST /v1/knowledge/erlewine/context: Retrieve rights-cleared Michael Erlewine context for controlled interpretation workflows without exposing raw archive internals.