Muhurat — Marriage (Vivah)

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

Code Samples

cURL

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 }'

Node.js

const res = await fetch('https://api.astroway.info/v1/vedic/muhurat/marriage', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "search_window_start": "2026-05-15",
    "search_window_end": "2026-05-31",
    "latitude": 28.61,
    "longitude": 77.21,
    "timezoneOffset": 5.5,
    "topN": 10
  }),
});
const { ok, data, error } = await res.json();
if (!ok) throw new Error(error.message);
console.log(data);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/muhurat/marriage',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
      'search_window_start': "2026-05-15",
      'search_window_end': "2026-05-31",
      'latitude': 28.61,
      'longitude': 77.21,
      'timezoneOffset': 5.5,
      'topN': 10
    },
)
result = r.json()
if not result['ok']:
    raise RuntimeError(result['error']['message'])
print(result['data'])

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('vedic/muhurat/marriage', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'search_window_start' => '2026-05-15',
        'search_window_end' => '2026-05-31',
        'latitude' => 28.61,
        'longitude' => 77.21,
        'timezoneOffset' => 5.5,
        'topN' => 10,
    ],
]);
$result = json_decode($r->getBody(), true);
if (!$result['ok']) throw new \RuntimeException($result['error']['message']);
print_r($result['data']);

Request Body ^required

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

number

0 nullable

ayanamsaId

number

nullable

topN

integer

default: 10 >= 1 <= 60

key

additional properties

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

object

ok

boolean

Example

true

data

object

activity

string

search_window

object

start

string

end

string

daysScanned

number

location

object

ayanamsa

number

auspiciousWindows

Array<object>

object

date

string

weekdayName

string

panchang

object

tithi

number

tithiName

string

paksha

string

nakshatra

number

nakshatraName

string

yoga

number

karana

string

abhijitMuhurat

object

startTime

string

endTime

string

score

number

rating

string

factors

Array

nextAuspiciousWindow

string

400

Validation error

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

Example

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