HomeAPI Docs › Batch Milan API

Batch Milan API

Bulk compatibility scoring for matrimony platforms — Hindi + English in every response.

2endpoints
hi + enbilingual JSON
Lahiriayanamsa
Freeunlimited test mode

Get a free API key Try it in the playground

Quick start

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 — the response structure is guaranteed identical to production, so you can build your whole integration before paying anything.

All Batch Milan endpoints

EndpointWhat it returns
POST /v1/milan/batchScore 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.
POST /v1/milan/batch/webhook-testSend a test payload to your webhook to verify it's working.

Frequently asked questions

What does the Batch Milan API return?

Bulk compatibility scoring for matrimony platforms. Every response is JSON with both Hindi and English strings, computed astronomically on the Lahiri ayanamsa (the Indian government standard). This module has 2 endpoints.

Can I try the Batch Milan API for free?

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.

How is GrahaAPI priced?

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