Home › API Docs › Muhurta API › Muhurta Marriage

Muhurta Marriage

POST /v1/muhurta/marriage

Auspicious marriage muhurtas (Vivah muhurta).

Example request

curl -X POST https://api.grahaapi.com/v1/muhurta/marriage   -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.

Request fields

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

Example body

{
  "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

Related Muhurta endpoints

/v1/muhurta/abhijit · /v1/muhurta/business · /v1/muhurta/choghadiya · /v1/muhurta/education · /v1/muhurta/find · /v1/muhurta/full