Muhurat: Marriage (Vivah)

POST

/vedic/muhurat/marriage

request.sh

curl -X POST https://api.astroway.info/v1/vedic/muhurat/marriage \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "search_window_start": "2026-05-15", "search_window_end": "2026-05-31", "latitude": 28.61, "longitude": 77.21, "timezoneOffset": 5.5, "topN": 10 }'

▸ Спробувати POST /vedic/muhurat/marriage

• Production

Auspicious-window scanner for marriage (Vivah Muhurat) over a date range. Scores each day by Tithi + Vara + Nakshatra + Yoga + Karana per Muhurta Chintamani Adhyaya 5 + B.V.Raman Muhurta Ch.6. Preferred nakshatras: Rohini/Mrigashira/Magha/Hasta/Swati/Anuradha/Mula/U.Phalguni/U.Ashadha/U.Bhadrapada/Revati. Avoid Sun/Tue/Sat. Returns top-N days sorted by score with per-day Abhijit Muhurat sub-window.

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

fields

string

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

Example

planets.name,planets.longitude

precision

integer

<= 15

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Example

4

Request Body ^required

Media type application/json

object

search_window_start required

string

/^\d{4}-\d{2}-\d{2}$/

search_window_end

string

/^\d{4}-\d{2}-\d{2}$/

latitude

number

0 nullable

longitude

number

0 nullable

timezoneOffset

Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.

number

0 nullable >= -14 <= 14

ayanamsaId

number

nullable

ayanamsa

Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.

string

Allowed values: fagan-bradley lahiri de-luce raman krishnamurti kp yukteshwar jn-bhasin true-citra djwhal-khul

topN

integer

default: 10 >= 1 <= 60

key additional

nullable

Example

{
  "search_window_start": "2026-05-15",
  "search_window_end": "2026-05-31",
  "latitude": 28.61,
  "longitude": 77.21,
  "timezoneOffset": 5.5,
  "topN": 10
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

activity

string

nullable

search_window

object

start

string

nullable

end

string

nullable

daysScanned

number

nullable

location

object

latitude

number

nullable

longitude

number

nullable

timezoneOffset

number

nullable

ayanamsa

number

nullable

auspiciousWindows

Array<object>

nullable

object

date

string

nullable

weekday

number

nullable

weekdayName

string

nullable

panchang

object

tithi

number

nullable

tithiName

string

nullable

paksha

string

nullable

vara

number

nullable

varaName

string

nullable

nakshatra

number

nullable

nakshatraName

string

nullable

yoga

number

nullable

yogaName

string

nullable

karana

string

nullable

karanaIndex

number

nullable

pada

number

nullable

abhijitMuhurat

object

startTime

string

nullable

endTime

string

nullable

midHour

number

nullable

score

number

nullable

rating

string

nullable

factors

Array<object>

nullable

object

field

string

nullable

delta

number

nullable

note

string

nullable

nextAuspiciousWindow

string

nullable

Example

{
  "ok": true,
  "data": {
    "activity": "marriage",
    "search_window": {
      "start": "2026-05-15",
      "end": "2026-05-31",
      "daysScanned": 17
    },
    "location": {
      "latitude": 28.61,
      "longitude": 77.21,
      "timezoneOffset": 5.5
    },
    "ayanamsa": 24.225448485258198,
    "auspiciousWindows": [
      {
        "date": "2026-05-29",
        "weekday": 5,
        "weekdayName": "Shukravara",
        "panchang": {
          "tithi": 13,
          "tithiName": "Trayodashi",
          "paksha": "shukla",
          "vara": 5,
          "varaName": "Shukravara",
          "nakshatra": 15,
          "nakshatraName": "Swati",
          "yoga": 22,
          "yogaName": "Sadhya",
          "karana": "Taitila",
          "karanaIndex": 26,
          "pada": 4
        },
        "abhijitMuhurat": {
          "startTime": "11:51:03",
          "endTime": "12:46:17",
          "midHour": 12.311103828251362
        },
        "score": 9,
        "rating": "excellent",
        "factors": [
          {
            "field": "nakshatra",
            "delta": 3,
            "note": "Swati: auspicious for marriage"
          }
        ]
      }
    ],
    "nextAuspiciousWindow": "2026-05-29"
  }
}

400

Validation error

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}