POST /v1/muhurta/personal
Personal (kundli-based) muhurta finder — the full screen a traditional astrologer performs before fixing a date, personalised to one birth chart (or, for marriage, to BOTH charts). HARD GATES (never relaxed). 1) Kundli gate: the natal chart is analysed — the purpose's karaka planet, malefic pressure on the 4th/8th houses, Sade Sati/Dhaiyya — and Vimshottari pratyantar sub-periods whose lord is the 8th lord or a dusthana-connected malefic are excluded outright. 2) Balvaan-chandra window: only dates from Shukla Navami to Krishna Shashti (a strong Moon) are considered. 3) Jupiter AND Venus must be udit (not combust) in transit. 4) Tarabala from the person's own birth star — Vipat/Pratyak/Vadha days vetoed. 5) Chandrashtama veto (transit Moon 8th from natal Moon). For marriage/griha pravesh the karaka must also not be combust/debilitated in transit (classical asta-shuddhi). WEIGHTED SCORING: surviving dates are scored by importance percentages — tarabala 60, yoga 32 (ten ashubh yogas excluded), karana 16 (Vishti + fixed karanas excluded), vaar 8 (shubh Mon/Wed/Thu, saumya Fri; krur Tue/Sat/Sun avoided), nakshatra 4 (purpose list), tithi 1 (groups ranked Jaya > Purna > Nanda > Bhadra > Rikta) — reported as a 0-100 score. If no date passes everything, the lowest-weight requirements are relaxed first (tithi → nakshatra → vaar → karana → yoga) and every relaxation is declared in the response — tarabala and the hard gates are never relaxed. MARRIAGE: pass the second person's chart in `birth2` — the entire screen runs on both kundlis and only the dates common to both are returned, ranked by the weaker chart's score. Requires `birth` in the request body.
curl -X POST https://api.grahaapi.com/v1/muhurta/personal -H "Authorization: Bearer sk-test-your-key" -H "Content-Type: application/json" -d '{"birth":{"dob":"1990-06-15","lat":28.6139,"lon":77.209,"tob":"10:30","tz":5.5},"from_date":"2026-07-01","lat":28.6139,"lon":77.209,"purpose":"marriage","to_date":"2026-07-31","tz":5.5}'Test keys (sk-test-…) are free and unlimited, and return the exact production response structure computed from a fixed sample chart. The response is JSON: {"success": true, "data": {…}, "meta": {…}} with Hindi + English strings, computed on the Lahiri ayanamsa.
| Field | Type | Required | Description |
|---|---|---|---|
from_date | string | ✅ | Search start date YYYY-MM-DD |
to_date | string | ✅ | Search end date YYYY-MM-DD |
lat | number | ✅ | Latitude |
lon | number | ✅ | Longitude |
tz | number | — | UTC offset (IST = 5.5) |
purpose | string | ✅ | Purpose: marriage, business, travel, education, griha_pravesh, vehicle_purchase, property_purchase, naamkaran |
birth | BirthRequest | null | — | Optional natal chart for personalised muhurta |
birth2 | BirthRequest | null | — | Second person's natal chart (marriage only): the /personal endpoint screens BOTH charts and returns only the dates common to both |
{
"birth": {
"dob": "1990-06-15",
"lat": 28.6139,
"lon": 77.209,
"tob": "10:30",
"tz": 5.5
},
"from_date": "2026-07-01",
"lat": 28.6139,
"lon": 77.209,
"purpose": "marriage",
"to_date": "2026-07-31",
"tz": 5.5
}Get a free API key Try it in the playground
/v1/muhurta/abhijit · /v1/muhurta/business · /v1/muhurta/choghadiya · /v1/muhurta/education · /v1/muhurta/find · /v1/muhurta/full