Developer Docs

B2B API facade for KP astrology products.

Every production endpoint lives under `/api/b2b/v1/*`, requires a valid B2B API key, and returns the same JSON envelope: `success`, `request_id`, `data`, `usage`, and `error`.

Get API Key Open Console

Authentication

Send either a bearer token or the dedicated header. API keys are stored as hashes only and are displayed once when generated.

Authorization: Bearer kp_live_...
X-KP-API-Key: kp_live_...

Standard response

{
  "success": true,
  "request_id": "b2b_...",
  "data": {},
  "usage": {
    "plan_code": "growth",
    "calls_used_before": 321,
    "call_limit": 100000,
    "per_minute_limit": 300
  },
  "error": null
}

Endpoint groups

Charts/chart, /kp-chart, /vargas, /transit-chart

Time/dasha/levels, /dasha/for-date, /panchang, /hora

Matching/guna-milan, /matchmaking, /matchmaking-kpdp

Expert KP/expert/ruling-planets, /expert/cusp-promise, /expert/aspects

Prediction/expert/event-finder, /expert/personal-muhurat, /expert/dasha-transit

Remedies/remedies, /reports/sample-pdf, gemstone-ready logic

Example chart request

curl -X POST https://kpastro.academy/api/b2b/v1/chart \
  -H "Authorization: Bearer kp_live_..." \
  -H "Content-Type: application/json" \
  -d '{"birth":{"year":1992,"month":7,"day":18,"hour":6,"minute":20,"lat":28.6139,"lon":77.2090,"timezone":5.5}}'

Limits and errors

401Missing, invalid, or revoked API key.

402Subscription is expired or no active access exists.

429Monthly or per-minute limit reached with reset details.

500Internal facade failure; request and response payload are logged.

AI access policy

AI astrology platform access is documented and request-based only. The self-serve API does not expose live OpenAI or other model-provider endpoints without explicit approval.