API v1.0 - Production Ready

Auspicio API

Integrate Vedic muhurat calculations into your applications. Access panchang data, find auspicious dates, and more.

Quick Start

// Using fetch
const response = await fetch(
  'https://api.auspicio.in/api/muhurat/search?' +
  new URLSearchParams({
    ceremony: 'wedding',
    religion: 'hinduism',
    city: 'delhi',
    year: '2026',
    startMonth: '10',
    endMonth: '12'
  }),
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data.data.results);

Authentication

All API requests require authentication using a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Getting an API Key

To get an API key, contact us at api@auspicio.in with your use case. We offer free tier for developers and custom plans for businesses.

API Endpoints

GET/api/muhurat/search

Search for auspicious muhurat dates based on ceremony, location, and date range.

Parameters

Name	Type	Required	Description
ceremony	string	Yes	Ceremony slug (e.g., wedding, griha-pravesh, annaprashan)
religion	string	Yes	Religion slug (e.g., hinduism)
city	string	Yes	City slug or name (e.g., delhi, mumbai, varanasi)
year	number	Yes	Year (e.g., 2026)
startMonth	number	No	Start month (1-12), default: 1
endMonth	number	No	End month (1-12), default: 12
tradition	string	No	Tradition slug (e.g., north-indian, bengali, kashi)
strictness	string	No	Filter strictness: STRICT, TRADITIONAL, FLEXIBLE, RELAXED
limit	number	No	Maximum results to return (default: 50)

Response Example

{
  "success": true,
  "data": {
    "results": [
      {
        "date": "2026-11-15",
        "weekday": "Sunday",
        "score": 85,
        "grade": "A",
        "confidence": 0.92,
        "muhuratWindows": [
          {
            "type": "primary",
            "start": "2026-11-15T06:30:00.000Z",
            "end": "2026-11-15T09:30:00.000Z",
            "duration": 180,
            "quality": "excellent"
          }
        ],
        "panchang": {
          "tithi": "Shukla Panchami",
          "nakshatra": "Rohini",
          "yoga": "Siddhi",
          "karana": "Bava"
        },
        "warnings": []
      }
    ],
    "total": 45
  }
}

GET/api/panchang

Get detailed panchang information for a specific date and location.

Parameters

Name	Type	Required	Description
date	string	Yes	Date in YYYY-MM-DD format
city	string	Yes	City slug or name

Response Example

{
  "success": true,
  "data": {
    "date": "2026-06-02",
    "location": "Delhi",
    "tithi": {
      "name": "Shukla Tritiya",
      "paksha": "SHUKLA",
      "endTime": "2026-06-02T15:30:00.000Z"
    },
    "nakshatra": {
      "name": "Punarvasu",
      "lord": "Jupiter",
      "endTime": "2026-06-02T18:45:00.000Z"
    },
    "yoga": {
      "name": "Shubha",
      "nature": "Auspicious"
    },
    "karana": {
      "name": "Taitila"
    },
    "sunrise": "05:23",
    "sunset": "19:12",
    "rahuKaal": {
      "start": "07:53",
      "end": "09:23"
    }
  }
}

GET/api/locations

Get list of supported locations with their coordinates.

Parameters

Name	Type	Required	Description
state	string	No	Filter by state name
search	string	No	Search by city name

Response Example

{
  "success": true,
  "data": [
    {
      "name": "Delhi",
      "slug": "delhi",
      "state": "Delhi",
      "latitude": 28.6139,
      "longitude": 77.209,
      "timezone": "Asia/Kolkata"
    }
  ]
}

GET/api/ceremonies

Get list of supported ceremonies.

Parameters

Name	Type	Required	Description
religion	string	No	Filter by religion slug
category	string	No	Filter by category (WEDDING, BIRTH, HOME, etc.)

Response Example

{
  "success": true,
  "data": [
    {
      "name": "Wedding (Vivah)",
      "slug": "wedding",
      "category": "WEDDING",
      "description": "Hindu wedding ceremony",
      "requiresCoupleBirth": true
    }
  ]
}

Rate Limits

Free Tier

100

requests per day

Pro

10,000

requests per day

Enterprise

Unlimited

custom limits

Ready to Get Started?

Request API Access