POST /v1/milan/batch
Score many match pairs in one call — built for matrimony platforms. Send up to 1,000 pairs (`{"pair_id", "person1": {birth}, "person2": {birth}}`) and get a real Ashtakoot score (all 8 koots), verdict and Manglik check for each, keyed by your own `pair_id`. For larger batches include a `webhook_url` — results are processed in the background and POSTed to your webhook when ready.
curl -X POST https://api.grahaapi.com/v1/milan/batch -H "Authorization: Bearer sk-test-your-key" -H "Content-Type: application/json" -d '{"pairs":[{"pair_id":"couple_001","person1":{"dob":"1990-06-15","lat":28.6139,"lon":77.209,"name":"Rahul Sharma","tob":"10:30","tz":5.5},"person2":{"dob":"1993-08-22","lat":26.9124,"lon":75.7873,"name":"Priya Singh","tob":"14:15","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 |
|---|---|---|---|
pairs | MilanPair[] | ✅ | List of person pairs to score (max 1,000 for sync; use webhook_url for larger batches) |
webhook_url | string | null | — | Webhook URL for async delivery (required when pairs > 1,000) |
{
"pairs": [
{
"pair_id": "couple_001",
"person1": {
"dob": "1990-06-15",
"lat": 28.6139,
"lon": 77.209,
"name": "Rahul Sharma",
"tob": "10:30",
"tz": 5.5
},
"person2": {
"dob": "1993-08-22",
"lat": 26.9124,
"lon": 75.7873,
"name": "Priya Singh",
"tob": "14:15",
"tz": 5.5
}
}
]
}Get a free API key Try it in the playground