Ai Compatibility

POST/v1/ai/compatibility

AI compatibility analysis between two birth charts. Strengths, challenges and the verdict come back in the requested language ("en" or "hi").

Example request

cURL
curl -X POST https://api.grahaapi.com/v1/ai/compatibility \
  -H "Authorization: Bearer sk-test-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "language": "en",
    "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": {…}} in the language you request ("language": "en" | "hi"), computed on the Lahiri ayanamsa.

Request fields

FieldTypeRequiredDescription
person1BirthRequestrequiredFirst person's birth details
person2BirthRequestrequiredSecond person's birth details
languagestringoptionalResponse language: 'en' (English) or 'hi' (Hindi). Each language = 1 AI call.

Example body

JSON
{
  "language": "en",
  "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
  }
}