Muhurta API

Overview

Muhurta is the Vedic science of electional astrology - selecting auspicious times for important activities. This API analyzes:

Tithi: Lunar day (avoid Rikta and Bhadra tithis)
Nakshatra: Moon's asterism (Fixed, Movable, Mixed suitability)
Yoga: Luni-solar combination (avoid Vishkumbha, Parigha, etc.)
Karana: Half-tithi (avoid Vishti/Bhadra)
Vara: Day of week (activity-specific recommendations)
Tarabala: Star compatibility with Moon
Chandrabala: Moon's strength analysis

Smart Muhurta: Our algorithm considers all 5 Panchanga elements plus special considerations for each activity type to find truly auspicious moments.

Request

cURL

curl -X POST "https://api.vedika.io/v2/astrology/muhurta" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "activity": "marriage",
    "startDate": "2026-02-01",
    "endDate": "2026-02-28",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "Asia/Kolkata",
    "birthNakshatra": "Rohini"
  }'

JavaScript

const response = await fetch('https://api.vedika.io/v2/astrology/muhurta', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    activity: 'marriage',
    startDate: '2026-02-01',
    endDate: '2026-02-28',
    latitude: 28.6139,
    longitude: 77.2090,
    timezone: 'Asia/Kolkata',
    birthNakshatra: 'Rohini'
  })
});

const data = await response.json();

Python

import requests

response = requests.post(
    'https://api.vedika.io/v2/astrology/muhurta',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'activity': 'marriage',
        'startDate': '2026-02-01',
        'endDate': '2026-02-28',
        'latitude': 28.6139,
        'longitude': 77.2090,
        'timezone': 'Asia/Kolkata',
        'birthNakshatra': 'Rohini'
    }
)

data = response.json()

Parameters

Parameter	Type	Required	Description
`activity`	string	Required	Type of activity (see supported activities below)
`startDate`	string	Required	Search start date (YYYY-MM-DD)
`endDate`	string	Required	Search end date (YYYY-MM-DD), max 90 days range
`latitude`	number	Required	Location latitude (-90 to 90)
`longitude`	number	Required	Location longitude (-180 to 180)
`timezone`	string	Optional	IANA timezone (default: "UTC")
`birthNakshatra`	string	Optional	Person's birth nakshatra for Tarabala calculation
`maxResults`	number	Optional	Maximum muhurtas to return (default: 10, max: 50)

Supported Activities

Life Events

marriage - Vivah Muhurta
engagement - Sagai
naming_ceremony - Namkaran
upanayana - Thread ceremony
annaprashan - First rice

Property & Travel

griha_pravesh - Housewarming
property_purchase - Buying property
construction - Start building
travel - Journey start
vehicle_purchase - New vehicle

Business & Career

business_start - New venture
job_joining - New job
contract_signing - Agreements
investment - Financial decisions
exam - Important exams

Response

{
  "success": true,
  "data": {
    "activity": "marriage",
    "searchRange": {
      "start": "2026-02-01",
      "end": "2026-02-28"
    },
    "location": {
      "latitude": 28.6139,
      "longitude": 77.2090,
      "timezone": "Asia/Kolkata"
    },
    "muhurtas": [
      {
        "rank": 1,
        "date": "2026-02-12",
        "startTime": "10:15:00",
        "endTime": "12:45:00",
        "score": 92,
        "panchanga": {
          "tithi": { "name": "Shukla Panchami", "score": 9 },
          "nakshatra": { "name": "Rohini", "score": 10, "suitable": true },
          "yoga": { "name": "Siddha", "score": 9 },
          "karana": { "name": "Bava", "score": 8 },
          "vara": { "name": "Thursday", "lord": "Jupiter", "score": 9 }
        },
        "specialFactors": {
          "tarabala": { "compatible": true, "star": 1 },
          "chandrabala": { "strong": true, "house": 2 },
          "abhijitMuhurta": true,
          "rahuKaal": false,
          "yamaghanta": false,
          "gulika": false
        },
        "auspiciousFor": ["marriage", "engagement", "new ventures"],
        "avoidFor": [],
        "recommendation": "Excellent muhurta with Rohini nakshatra - highly auspicious for marriage ceremonies"
      },
      {
        "rank": 2,
        "date": "2026-02-19",
        "startTime": "09:30:00",
        "endTime": "11:15:00",
        "score": 88,
        "panchanga": {
          "tithi": { "name": "Shukla Dwadashi", "score": 8 },
          "nakshatra": { "name": "Uttara Phalguni", "score": 9, "suitable": true },
          "yoga": { "name": "Shubha", "score": 9 },
          "karana": { "name": "Kaulava", "score": 8 },
          "vara": { "name": "Thursday", "lord": "Jupiter", "score": 9 }
        },
        "specialFactors": {
          "tarabala": { "compatible": true, "star": 4 },
          "chandrabala": { "strong": true, "house": 11 },
          "abhijitMuhurta": false,
          "rahuKaal": false,
          "yamaghanta": false,
          "gulika": false
        },
        "auspiciousFor": ["marriage", "long journeys", "property"],
        "avoidFor": [],
        "recommendation": "Strong muhurta with Uttara Phalguni - promotes lasting unions"
      }
      // ... more muhurtas
    ],
    "inauspiciousPeriods": [
      {
        "date": "2026-02-04",
        "reason": "Amavasya (New Moon) - avoid new beginnings",
        "severity": "high"
      },
      {
        "date": "2026-02-15",
        "reason": "Vishti Karana - inauspicious for marriages",
        "severity": "medium"
      }
    ],
    "summary": {
      "totalMuhurtasFound": 8,
      "bestDate": "2026-02-12",
      "worstDates": ["2026-02-04", "2026-02-18"]
    }
  },
  "metadata": {
    "requestId": "req_muhurta_abc123",
    "calculatedAt": "2026-01-07T12:00:00Z",
    "cost": 0.004
  }
}

Muhurta Score Guide

90-100

Excellent - Ideal timing

75-89

Good - Favorable timing

60-74

Average - Acceptable

<60

Poor - Best to avoid

Related Endpoints

POST /choghadiya

Daily choghadiya timings

POST /rahu-kaal

Rahu Kaal timings

POST /panchang

Daily panchang details