POSTalphaExperience APIs
Past-Life Reading
Generate an AstraGate-style past-life reading with structured scene, karmic pattern, present-life echo, healing action, and empowerment.
Credits
10 credits per reading
Minimum Plan
Pro+
Billing Lane
Premium AI
SDK Helper
pastLifeReading / past_life_reading
Inputs
- +optional birth data
- +question
- +focus
- +depth
Outputs
- +lifetime theme
- +scene
- +karmic pattern
- +present-life echo
- +healing action
Tool Functions
Capabilities behind this endpoint
pastlife.reading.generateCreates a structured past-life reading.
astragate.persona.applyUses the AstraGate persona contract and past-life knowledge.
quality.experience.enforceRequires complete structured output before billing is recorded.
Soul Mission request
{
"subject": { "id": "user_123", "dob": "1990-07-23" },
"focus": "soul_mission",
"question": "What old pattern am I here to complete?"
}Soul Mission response
{
"request_id": "req_...",
"data": {
"lifetime_theme": "A life of carrying sacred knowledge while hiding your public voice.",
"healing_action": "Choose one truth and speak it plainly this week."
},
"usage": { "lane": "ai", "credits": 10, "billableUnits": 1 }
}curl
curl https://theleokingai.com/api/v1/past-life/reading \
-X POST \
-H "Accept: application/json" \
-H "x-api-key: $LEOKING_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: past-life-reading-subject-123-v1" \
-d '{
"subject": { "id": "user_123", "dob": "1990-07-23" },
"focus": "soul_mission",
"question": "What old pattern am I here to complete?"
}'Node SDK
import { TheLeoKingApi } from "@theleoking/ai-api";
const api = new TheLeoKingApi({
apiKey: process.env.LEOKING_API_KEY,
baseUrl: "https://theleokingai.com/api"
});
const result = await api.pastLifeReading(
{
"subject": { "id": "user_123", "dob": "1990-07-23" },
"focus": "soul_mission",
"question": "What old pattern am I here to complete?"
},
"past-life-reading-subject-123-v1"
);
console.log(result.request_id);
console.log(result.usage.credits);Python SDK
import os
from theleoking_ai_api import TheLeoKingApi
api = TheLeoKingApi(
api_key=os.environ["LEOKING_API_KEY"],
base_url="https://theleokingai.com/api",
)
result = api.past_life_reading(
{
"subject": {
"id": "user_123",
"dob": "1990-07-23",
},
"focus": "soul_mission",
"question": "What old pattern am I here to complete?",
},
idempotency_key="past-life-reading-subject-123-v1",
)
print(result["request_id"])
print(result["usage"]["credits"])Error Behavior
| HTTP | Code | Partner Action |
|---|---|---|
| 400 | INVALID_REQUEST | Fix the payload shape, enum value, required field, or request body before retrying. |
| 401 | AUTH_REQUIRED | Send x-api-key from a trusted server environment. Do not expose keys in browser code. |
| 401 | AUTH_INVALID | Check the key prefix, rotate compromised keys, and verify the target environment. |
| 402 | CREDITS_EXHAUSTED | Upgrade the plan, add credits, or switch to a lower-cost Core Compute route. |
| 403 | AUTH_FORBIDDEN | Use a key scoped for this endpoint or upgrade to the required plan. |
| 404 | NOT_FOUND | Verify the job id, environment, API key, and whether the job belongs to the same workspace. |
| 409 | IDEMPOTENCY_CONFLICT | Reuse idempotency keys only for the same logical operation and identical request payload. |
| 429 | RATE_LIMITED | Back off, retry later, reduce concurrency, or request enterprise limits. |
Related Endpoints