Batch Milan

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.

Example request

cURL
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 name twins where available (e.g. sign / sign_hi), computed on the Lahiri ayanamsa.

Request fields

FieldTypeRequiredDescription
pairsMilanPair[]requiredList of person pairs to score (max 1,000 for sync; use webhook_url for larger batches)
webhook_urlstring | nulloptionalWebhook URL for async delivery (required when pairs > 1,000)

Example body

JSON
{
  "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
      }
    }
  ]
}