Birth Time Rectification: refine uncertain birth time from life events — Hindi + English in every response.
Get a free API key Try it in the playground
curl -X POST https://api.grahaapi.com/v1/rectification/ai-suggest \
-H "Authorization: Bearer sk-test-your-key" \
-H "Content-Type: application/json" \
-d '{"approx_tob":"22:00","day_unknown":false,"dob":"1990-06-15","events":[{"date":"2015-11-23","note":"","type":"marriage"},{"date":"2010-07-01","note":"First tech job","type":"job_start"}],"lat":28.6139,"lon":77.209,"step_minutes":4,"time_range_minutes":60,"tz":5.5}'Test keys (sk-test-…) are free and unlimited — the response structure is guaranteed identical to production, so you can build your whole integration before paying anything.
| Endpoint | What it returns |
|---|---|
| POST /v1/rectification/ai-suggest | Runs the same engine as /event-score internally, pre-filtered to the top 3 candidates with a plain-text rank/confidence summary in each language. Note: this does NOT call the Astro Shivanii AI module — no LLM/AI logic is involved, it's the identical dasha+transit scoring math as /event-score (see that endpoint's docstring), just reformatted to the 3 best candidates. Use /event-score directly if you want the full candidate list and per-event dasha/transit score breakdown. |
| POST /v1/rectification/ascendant-options | Return all 12 ascendant rising windows for the birth day with physical & personality traits. Use this when birth time is completely unknown. |
| POST /v1/rectification/event-score | The main rectification engine. Tests every candidate time inside ±time_range_minutes of approx_tob (and, when day_unknown=True, every day of that month too), scoring each by matching active Vimshottari dasha lords on your known event dates to the event-relevant houses, GATED by transiting Jupiter/Saturn/Rahu/Ketu/Mars on those same dates (Gochar) — dasha sets multi-year eligibility, transit is the trigger within it. Optionally (use_kp=true, OFF by default — see EventScoreRequest.use_kp) also gates by the real KP significator method (reuses this API's own /v1/kp house-significator logic); tested against the real case this engine is validated against and found genuinely neutral (no demonstrated benefit, plus real added computation cost), so it's available for callers who want the extra corroborating signal, not shipped as an on-by-default improvement. Also optionally (use_primary_directions=true, OFF by default — see EventScoreRequest.use_primary_directions) gates by classical Western Primary Directions; tested and found essentially no discriminating effect on the real case. Each `event_breakdown[]` entry exposes `dasha_score`/`transit_score`/`kp_score`/`primary_directions_score` separately alongside the combined `score`. Set `use_transit=false` to fall back to pure dasha-only scoring. Returns ranked candidates with confidence scores — the top result is your best-estimate rectified birth time (and date, when day_unknown=True). |
| POST /v1/rectification/kp-ruling-planets | KP ruling planet method: At the query moment, 6 ruling planets are identified. The birth time is valid when the Lagna sub lord at birth matches one of these. Returns ruling planets + sub lord for every 4-minute window in the search range. |
Birth Time Rectification: refine uncertain birth time from life events. Every response is JSON with both Hindi and English strings, computed astronomically on the Lahiri ayanamsa (the Indian government standard). This module has 4 endpoints.
Yes — sk-test- keys are free and unlimited, and return the exact production response structure (computed from a fixed sample chart). The Free plan then gives 1,000 real API calls per month with no credit card.
Simple INR pricing: Free (1,000 calls/mo), then paid plans from ₹499/mo. One call = one call on every endpoint — no credit system. Paid plans are throttled over quota, never blocked.
Full interactive reference for all 237 endpoints: GrahaAPI Docs · Plain-language explainers: Wiki