{"name":"The Leo King Business Intelligence API","version":"v1","contractVersion":"2026-07-06.enterprise-docs-v1","auth":{"header":"x-api-key","idempotency":"Idempotency-Key"},"links":{"docs":"/api-docs","product":"/api-platform","console":"/api-console","lab":"/api-console/lab","billing":"/api-console/billing","index":"/api/v1","openapi":"/api/v1/openapi","status":"/api/v1/status","sla":"/api/v1/sla","incidents":"/api/v1/incidents","changelog":"/api/v1/changelog","webhooks":"/api/v1/webhooks","errors":"/api/v1/errors","postman":"/api/v1/postman","readiness":"/api/v1/ops/readiness?deep=1","llms":"/llms.txt","llmsFull":"/llms-full.txt"},"endpoints":{"/api/v1/audience/insights":{"method":"POST","credits":"2 credits per customer","group":"intelligence","status":"live","description":"Generate customer-level buyer archetypes, campaign fit, timing notes, and message angles from birth data and campaign context.","functions":["customer.profile.score","campaign.fit.evaluate","message.angle.generate","chart.quality.report","erlewine.context.attach"]},"/api/v1/experiences/future-partner-vision":{"method":"POST","credits":"8 credits per vision","group":"experiences","status":"alpha","description":"Generate a structured future partner profile, relationship scene, attraction pattern, timing window, and optional image prompt from birth data and love context.","functions":["partner.vision.generate","love.signature.extract","timing.romance.window","image.prompt.partner","quality.experience.enforce"]},"/api/v1/experiences/love-reveal":{"method":"POST","credits":"5 credits per reveal","group":"experiences","status":"alpha","description":"Generate a high-specificity love reading that can blend psychic interpretation, tarot symbolism, owned astrology context, and 5-7-8 relationship logic.","functions":["love.reveal.generate","question.intent.classify","tarot.symbols.attach","relationship.context.ground"]},"/api/v1/experiences/crystal-ball":{"method":"POST","credits":"4 credits per vision","group":"experiences","status":"alpha","description":"Generate a cinematic symbolic vision with concrete interpretation, action guidance, and optional image-generation direction.","functions":["vision.crystal.generate","symbols.interpret","image.prompt.crystal"]},"/api/v1/oracle/ask":{"method":"POST","credits":"2 credits per answer","group":"experiences","status":"alpha","description":"Answer a direct spiritual question through the paid Lady Avalon API path with strict JSON output, usage metering, and no legacy MCP dependency.","functions":["oracle.ask.generate","sun.sign.derive","quality.experience.enforce"]},"/api/v1/tarot/draw":{"method":"POST","credits":"2 credits per spread","group":"experiences","status":"alpha","description":"Draw and interpret tarot spreads from the local 78-card Rider-Waite-Smith corpus with deterministic seed support and paid API metering.","functions":["tarot.spread.draw","tarot.meanings.apply","tarot.output.lock"]},"/api/v1/past-life/reading":{"method":"POST","credits":"10 credits per reading","group":"experiences","status":"alpha","description":"Generate an AstraGate-style past-life reading with structured scene, karmic pattern, present-life echo, healing action, and empowerment.","functions":["pastlife.reading.generate","astragate.persona.apply","quality.experience.enforce"]},"/api/v1/charts/synastry":{"method":"POST","credits":"3 credits per pair","group":"relationships","status":"alpha","description":"Return owned geocentric tropical synastry data and relationship aspect overlays without calling an external astrology API.","functions":["chart.synastry.calculate","interchart.aspects.rank","relationship.signals.extract","calculation.basis.report"]},"/api/v1/compatibility/score":{"method":"POST","credits":"4 credits per pair","group":"relationships","status":"alpha","description":"Score relationship compatibility using synastry, 5-7-8 house activation, love-planet frameworks, and optional StarTypes background comparison.","functions":["compatibility.score.calculate","love.578.evaluate","synastry.signals.weight","helio.background.compare"]},"/api/v1/charts/natal":{"method":"POST","credits":"2 credits per chart","group":"charts","status":"alpha","description":"Return a geocentric tropical natal chart from the Kerykeion/Swiss sidecar for partners that need raw chart data, not generated interpretation.","functions":["chart.natal.calculate","planet.positions.list","houses.resolve","aspects.list","birth.input.validate"]},"/api/v1/charts/transits":{"method":"POST","credits":"2 credits per chart","group":"charts","status":"alpha","description":"Return geocentric tropical transit positions and aspects from the owned sidecar for timing, daily horoscope, and ephemeris workflows.","functions":["chart.transits.calculate","transit.positions.list","transit.aspects.rank","mundane.signal.seed","daily.horoscope.seed"]},"/api/v1/charts/current-sky":{"method":"POST","credits":"1 credit per lookup","group":"charts","status":"alpha","description":"Return the owned geocentric tropical current-sky chart for a supplied moment and location without calling external astrology APIs.","functions":["chart.current_sky.calculate","planet.positions.list","houses.resolve","lunar.phase.extract"]},"/api/v1/lunar/phase":{"method":"POST","credits":"1 credit per lookup","group":"charts","status":"alpha","description":"Return first-party Sun-Moon lunar phase context for a supplied moment and location without horoscope prose or third-party fallback.","functions":["lunar.phase.calculate","planet.positions.list","calculation.basis.report"]},"/api/v1/horoscope/daily":{"method":"POST","credits":"1 credit per sign or subject","group":"intelligence","status":"alpha","description":"Generate personalized daily horoscope output from owned transit substrate, zodiac knowledge, and optional birth profile context.","functions":["horoscope.daily.generate","transit.daily.seed","zodiac.knowledge.apply"]},"/api/v1/timing/windows":{"method":"POST","credits":"3 credits per run","group":"intelligence","status":"alpha","description":"Generate practical timing windows for launches, love, career, money, content, and spiritual work using owned transit substrate.","functions":["timing.windows.generate","transit.window.seed","strategy.timing.apply"]},"/api/v1/world/signals":{"method":"POST","credits":"5 credits per forecast","group":"intelligence","status":"live","description":"Generate Beyond The Veil style mundane intelligence with deterministic ephemeris context, BTV RAG metadata, and quality controls.","functions":["mundane.forecast.generate","ephemeris.transits.rank","signature.stack.apply","historical.analog.select","quality.gates.enforce"]},"/api/v1/world/signals/jobs":{"method":"POST","credits":"reserves 5 credits; charges only on complete forecast","group":"intelligence","status":"live","description":"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.","functions":["mundane.forecast.job.create","credits.reserve","job.status.poll","mundane.forecast.generate","usage.bill.on_success"]},"/api/v1/mundane/hot-zones":{"method":"POST","credits":"5 credits per run","group":"intelligence","status":"alpha","description":"Rank supplied regions as Beyond The Veil style hot zones for a topic and time window using owned transit context and structured generation.","functions":["hotzones.score","mundane.region.rank","watch.items.generate"]},"/api/v1/mundane/analyze-event":{"method":"POST","credits":"4 credits per analysis","group":"intelligence","status":"alpha","description":"Analyze a supplied world event through mundane astrology and return forward-looking implications, analogs, watch windows, and action guidance.","functions":["mundane.event.analyze","event.signature.extract","forecast.implications.generate"]},"/api/v1/helio/patterns":{"method":"POST","credits":"1 credit per subject","group":"helio","status":"background","description":"Lookup heliocentric tropical StarTypes patterns with attribution to Michael Erlewine's contributions, source work, and interpretations as a background/evaluation signal.","functions":["startypes.lookup","helio.pattern.components","erlewine.source.credit","background.signal.guard"]},"/api/v1/knowledge/erlewine/context":{"method":"POST","credits":"1 credit per retrieval","group":"knowledge","status":"planned","description":"Retrieve rights-cleared Michael Erlewine context for controlled interpretation workflows without exposing raw archive internals.","functions":["erlewine.context.search","source.credit.format","rights.bucket.filter"]}},"pricing":[{"name":"Core Compute","internalPlan":"core","clerkPlanSlug":"core","monthlyPrice":"$99/mo","monthlyCredits":5000,"requestLimitPerMinute":80,"aiPolicy":"No generative AI is included. Core routes record core credits only and avoid token-based usage charges."},{"name":"Basic","internalPlan":"developer","clerkPlanSlug":"basic","monthlyPrice":"$199/mo","monthlyCredits":10000,"requestLimitPerMinute":120,"aiPolicy":"Core routes avoid generative AI. Light AI routes are opt-in and consume 4-8 AI credits per completed response."},{"name":"Pro","internalPlan":"growth","clerkPlanSlug":"pro","monthlyPrice":"$799/mo","monthlyCredits":50000,"requestLimitPerMinute":240,"aiPolicy":"Designed for regular AI endpoint use with usage reviewed by endpoint and product lane."},{"name":"Business","internalPlan":"scale","clerkPlanSlug":"business","monthlyPrice":"$2,500/mo","monthlyCredits":200000,"requestLimitPerMinute":600,"aiPolicy":"Built for heavy AI usage with cost review before custom content generation expansion."},{"name":"Enterprise","internalPlan":"enterprise","clerkPlanSlug":"enterprise","monthlyPrice":"Custom, $10k+/mo target","monthlyCredits":1000000,"requestLimitPerMinute":1200,"aiPolicy":"Custom credit pricing, committed usage, and separate terms for high-cost media generation products."}],"platformClaims":["No third-party AstrologyAPI dependency in the product roadmap.","Geocentric tropical chart work stays separate from heliocentric tropical StarTypes.","StarTypes is helio-only background signal until evals prove lead use cases.","Experience endpoints are sellable products, not demo chatbot wrappers.","Every generative endpoint needs output quality gates before production scale."],"roadmap":[{"title":"Live foundation","status":"live","summary":"The public API, checkout route, customer console, usage dashboard, API Lab, and no-AI core routes are in place."},{"title":"Full Erlewine StarTypes layer","status":"live","summary":"The helio tropical StarTypes endpoint now uses the full packaged Michael Erlewine short ephemeris lookup instead of the old pilot slice."},{"title":"Self-serve beta hardening","status":"beta","summary":"The next commercial gate is making a buyer able to discover plans, check out, create keys, run examples, and see usage without hand-holding."},{"title":"Endpoint expansion","status":"next","summary":"The strongest roadmap is deeper business functions around dating apps, creator funnels, media intelligence, world signals, and premium spiritual products."},{"title":"Enterprise platform","status":"enterprise","summary":"Large partners need private contracts, committed usage, custom endpoints, stronger observability, and optional realtime or callback products."}],"legacyEndpoints":["/api/v1/customer/profile","/api/v1/mundane/forecast"],"docs":{"human":"/api-docs","openapi":"/api/v1/openapi","console":"/api-console","status":"/api/v1/status","sla":"/api/v1/sla","incidents":"/api/v1/incidents","changelog":"/api/v1/changelog","webhooks":"/api/v1/webhooks","errors":"/api/v1/errors","postman":"/api/v1/postman","llms":"/llms.txt","llmsFull":"/llms-full.txt"},"developerPlatform":{"links":{"docs":"/api-docs","product":"/api-platform","console":"/api-console","lab":"/api-console/lab","billing":"/api-console/billing","index":"/api/v1","openapi":"/api/v1/openapi","status":"/api/v1/status","sla":"/api/v1/sla","incidents":"/api/v1/incidents","changelog":"/api/v1/changelog","webhooks":"/api/v1/webhooks","errors":"/api/v1/errors","postman":"/api/v1/postman","readiness":"/api/v1/ops/readiness?deep=1","llms":"/llms.txt","llmsFull":"/llms-full.txt"},"statusComponents":[{"name":"REST API Gateway","status":"live","scope":"Server-to-server /api/v1 routes with API-key auth and standard envelopes."},{"name":"OpenAPI Contract","status":"live","scope":"Machine-readable OpenAPI 3.1 contract for generated clients and review."},{"name":"Human Developer Docs","status":"live","scope":"Discoverable docs page, quickstart, examples, endpoint reference, plans, and enterprise path."},{"name":"API Console And Lab","status":"beta","scope":"Private console for keys, usage, billing, and endpoint testing."},{"name":"Core Compute","status":"beta","scope":"No-AI chart, sky, transit, lunar, synastry, compatibility, and helio background routes."},{"name":"AI Intelligence","status":"beta","scope":"Audience intelligence, premium experiences, oracle/tarot, horoscope, and world signals."},{"name":"Usage Ledger","status":"beta","scope":"Request id, endpoint, credits, billing lane, model, token metadata, and idempotency tracking."},{"name":"SDK Packages","status":"release_gate","scope":"Node and Python source exists; public npm/PyPI publication is still gated."},{"name":"Partner Webhooks","status":"next","scope":"Signed callbacks for async completion, usage, quality, billing, and entitlement events."},{"name":"SLA And Incident History","status":"live","scope":"Public SLA target and incident-history contract for discovery, procurement, and partner review."},{"name":"Audit And Security","status":"enterprise","scope":"Key-level audit exports, IP allowlists, retention terms, security packet, and private contract controls."}],"webhookEvents":[{"event":"world_signal.job.completed","status":"next","category":"async_job","delivery":"Signed HTTPS POST"},{"event":"world_signal.job.failed","status":"next","category":"async_job","delivery":"Signed HTTPS POST"},{"event":"usage.recorded","status":"next","category":"usage","delivery":"Signed HTTPS POST"},{"event":"quality.failed","status":"next","category":"quality","delivery":"Signed HTTPS POST"},{"event":"entitlement.updated","status":"enterprise","category":"entitlement","delivery":"Signed HTTPS POST"},{"event":"billing.subscription.updated","status":"enterprise","category":"billing","delivery":"Signed HTTPS POST"}],"changelog":[{"version":"v1 alpha","date":"2026-07-06","status":"live","title":"Developer docs and discovery upgrade"},{"version":"v1 alpha foundation","date":"2026-06","status":"beta","title":"Commercial API foundation"},{"version":"self-serve beta","date":"Next","status":"release_gate","title":"Generated clients and package publication"},{"version":"enterprise beta","date":"Planned","status":"enterprise","title":"Enterprise callback, SLA, audit, and security layer"}],"supportAssets":{"errors":{"href":"/api/v1/errors","count":11},"postman":{"href":"/api/v1/postman","format":"Postman Collection v2.1"},"sla":{"href":"/api/v1/sla","status":"public-contract"},"incidents":{"href":"/api/v1/incidents","status":"public-contract"}}},"envelope":{"success":["request_id","data","usage","meta"],"error":["request_id","error.code","error.message","error.details"]}}