Back to Docs

Vedic Daily Muhurat Lookup

Vedic Daily Muhurat Lookup

POST/api/v2/vedic/qa

Look up supported daily Vedic Muhurat topics with structured periods, full day/night tables, current period lookup, and Panchang calculation evidence.

Authentication: send x-api-key.

Full URL

https://api.freeastroapi.com/api/v2/vedic/qa
Safe retries with Idempotency-Key

Authenticated, billable astrology POST requests accept the optional header Idempotency-Key: <client-generated unique operation key>. Reuse the same key only when retrying the exact same method, path, query string, and JSON body after a timeout or network failure.

A completed replay returns the first response with Idempotency-Replayed: true, does not rerun the calculation, and does not consume extra quota. Keys are retained for about 24 hours.

Reusing a key with a changed request returns 409 idempotency_key_reused. A duplicate while the first request is still running returns 409 request_in_progress with Retry-After.

What It Returns

A structured lookup payload with the detected intent, human-readable answer, primary period where applicable, current_period for the supplied local time, grouped table sections, flat periods, Panchang context, warnings, and calculation metadata.

Example Request

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/qa" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "question": "chaughadia",
  "date": "2026-04-30",
  "time": "10:30",
  "city": "New Delhi",
  "lat": 28.62137,
  "lng": 77.2148,
  "ayanamsha": "lahiri",
  "language": "en"
}'

Request Parameters

Provide either city or both lat and lng. Coordinates are recommended for stable production results.

Field
question
Type
string
Required
Yes
Description
Supported daily Muhurat topic phrase carried in the existing question field. Official topics: abhijit muhurat, rahu kaal, brahma muhurat, do ghati muhurat, hora, chaughadia, gowri panchangam, panchak, and bhadra.
Field
date
Type
string
Required
No
Description
Target local date as YYYY-MM-DD. Defaults to today for the resolved location.
Field
time
Type
string
Required
No
Description
Optional local lookup time as HH:MM or HH:MM:SS. Used to populate current_period when applicable.
Field
city
Type
string
Required
No
Description
Location name. Optional when lat/lng are provided.
Field
lat
Type
float
Required
No
Description
Latitude. Recommended for stable production results.
Field
lng
Type
float
Required
No
Description
Longitude. Recommended for stable production results.
Field
tz_str
Type
string
Required
No
Description
Optional timezone override such as Asia/Kolkata, Europe/London, AUTO, or LMT. Defaults to AUTO when omitted.
Field
ayanamsha
Type
string
Required
No
Description
Vedic ayanamsha. Default is lahiri.
Field
language
Type
string
Required
No
Description
Response language. Only en is currently supported.

Response Shape

Field
intent
Type
string
Required
n/a
Description
Detected Vedic QA intent, such as chaughadia, hora, panchak, or bhadra.
Field
question
Type
string
Required
n/a
Description
Supported topic phrase sent by the client.
Field
answer
Type
string
Required
n/a
Description
Short human-readable answer.
Field
date
Type
string
Required
n/a
Description
Resolved local date used for calculation.
Field
location
Type
object
Required
n/a
Description
Resolved latitude and longitude.
Field
period
Type
object
Required
n/a
Description
Primary period for single-window answers such as Rahu Kaal or Brahma Muhurat.
Field
current_period
Type
object
Required
n/a
Description
Period active at the supplied/current local time when available.
Field
sections
Type
object
Required
n/a
Description
Grouped full-table sections such as day, night, or weekly.
Field
periods
Type
array
Required
n/a
Description
Flat list of all returned periods.
Field
panchang_context
Type
object
Required
n/a
Description
Sunrise, sunset, weekday, and Rahu Kalam context used by the answer.
Field
supported_questions
Type
array[string]
Required
n/a
Description
Supported internal intent keys.
Field
metadata
Type
object
Required
n/a
Description
Endpoint version, ruleset, ayanamsha, timezone, and calculation basis.

Real Request Example

This request uses the supported Chaughadia topic phrase for New Delhi with an explicit local lookup time.

{
  "question": "chaughadia",
  "date": "2026-04-30",
  "time": "10:30",
  "city": "New Delhi",
  "lat": 28.62137,
  "lng": 77.2148,
  "ayanamsha": "lahiri",
  "language": "en"
}

Real Response Example

This response was generated from the current V2 endpoint implementation for the example payload.

V2
{
  "intent": "chaughadia",
  "question": "chaughadia",
  "answer": "Chaughadia for 2026-04-30 contains 8 day periods and 8 night periods.",
  "date": "2026-04-30",
  "location": {
    "lat": 28.62137,
    "lng": 77.2148
  },
  "period": null,
  "current_period": {
    "id": "chaughadia_day_3",
    "name": "Udveg",
    "section": "day",
    "start": "2026-04-30T08:59:55.662681+05:30",
    "end": "2026-04-30T10:39:14.980549+05:30",
    "start_time": "08:59:55",
    "end_time": "10:39:14",
    "quality": "inauspicious",
    "duration_minutes": 99.32,
    "index": 3
  },
  "sections": {
    "day": [
      {
        "id": "chaughadia_day_1",
        "name": "Shoobh",
        "section": "day",
        "start": "2026-04-30T05:41:17.026945+05:30",
        "end": "2026-04-30T07:20:36.344813+05:30",
        "start_time": "05:41:17",
        "end_time": "07:20:36",
        "quality": "auspicious",
        "duration_minutes": 99.32,
        "index": 1
      },
      {
        "id": "chaughadia_day_2",
        "name": "Rog",
        "section": "day",
        "start": "2026-04-30T07:20:36.344813+05:30",
        "end": "2026-04-30T08:59:55.662681+05:30",
        "start_time": "07:20:36",
        "end_time": "08:59:55",
        "quality": "inauspicious",
        "duration_minutes": 99.32,
        "index": 2
      },
      {
        "id": "chaughadia_day_3",
        "name": "Udveg",
        "section": "day",
        "start": "2026-04-30T08:59:55.662681+05:30",
        "end": "2026-04-30T10:39:14.980549+05:30",
        "start_time": "08:59:55",
        "end_time": "10:39:14",
        "quality": "inauspicious",
        "duration_minutes": 99.32,
        "index": 3
      },
      {
        "id": "chaughadia_day_4",
        "name": "Chal",
        "section": "day",
        "start": "2026-04-30T10:39:14.980549+05:30",
        "end": "2026-04-30T12:18:34.298417+05:30",
        "start_time": "10:39:14",
        "end_time": "12:18:34",
        "quality": "good",
        "duration_minutes": 99.32,
        "index": 4
      },
      {
        "id": "chaughadia_day_5",
        "name": "Laabh",
        "section": "day",
        "start": "2026-04-30T12:18:34.298417+05:30",
        "end": "2026-04-30T13:57:53.616285+05:30",
        "start_time": "12:18:34",
        "end_time": "13:57:53",
        "quality": "auspicious",
        "duration_minutes": 99.32,
        "index": 5
      },
      {
        "id": "chaughadia_day_6",
        "name": "Amrut",
        "section": "day",
        "start": "2026-04-30T13:57:53.616285+05:30",
        "end": "2026-04-30T15:37:12.934153+05:30",
        "start_time": "13:57:53",
        "end_time": "15:37:12",
        "quality": "auspicious",
        "duration_minutes": 99.32,
        "index": 6
      },
      {
        "id": "chaughadia_day_7",
        "name": "Kaal",
        "section": "day",
        "start": "2026-04-30T15:37:12.934153+05:30",
        "end": "2026-04-30T17:16:32.252021+05:30",
        "start_time": "15:37:12",
        "end_time": "17:16:32",
        "quality": "inauspicious",
        "duration_minutes": 99.32,
        "index": 7
      },
      {
        "id": "chaughadia_day_8",
        "name": "Shoobh",
        "section": "day",
        "start": "2026-04-30T17:16:32.252021+05:30",
        "end": "2026-04-30T18:55:51.569889+05:30",
        "start_time": "17:16:32",
        "end_time": "18:55:51",
        "quality": "auspicious",
        "duration_minutes": 99.32,
        "index": 8
      }
    ],
    "night": [
      {
        "id": "chaughadia_night_1",
        "name": "Amrut",
        "section": "night",
        "start": "2026-04-30T18:55:51.569885+05:30",
        "end": "2026-04-30T20:16:25.829909+05:30",
        "start_time": "18:55:51",
        "end_time": "20:16:25",
        "quality": "auspicious",
        "duration_minutes": 80.57,
        "index": 1
      },
      {
        "id": "chaughadia_night_2",
        "name": "Chal",
        "section": "night",
        "start": "2026-04-30T20:16:25.829909+05:30",
        "end": "2026-04-30T21:37:00.089933+05:30",
        "start_time": "20:16:25",
        "end_time": "21:37:00",
        "quality": "good",
        "duration_minutes": 80.57,
        "index": 2
      },
      {
        "id": "chaughadia_night_3",
        "name": "Rog",
        "section": "night",
        "start": "2026-04-30T21:37:00.089933+05:30",
        "end": "2026-04-30T22:57:34.349957+05:30",
        "start_time": "21:37:00",
        "end_time": "22:57:34",
        "quality": "inauspicious",
        "duration_minutes": 80.57,
        "index": 3
      },
      {
        "id": "chaughadia_night_4",
        "name": "Kaal",
        "section": "night",
        "start": "2026-04-30T22:57:34.349957+05:30",
        "end": "2026-05-01T00:18:08.609981+05:30",
        "start_time": "22:57:34",
        "end_time": "24:18:08",
        "quality": "inauspicious",
        "duration_minutes": 80.57,
        "index": 4
      },
      {
        "id": "chaughadia_night_5",
        "name": "Laabh",
        "section": "night",
        "start": "2026-05-01T00:18:08.609981+05:30",
        "end": "2026-05-01T01:38:42.870005+05:30",
        "start_time": "24:18:08",
        "end_time": "25:38:42",
        "quality": "auspicious",
        "duration_minutes": 80.57,
        "index": 5
      },
      {
        "id": "chaughadia_night_6",
        "name": "Udveg",
        "section": "night",
        "start": "2026-05-01T01:38:42.870005+05:30",
        "end": "2026-05-01T02:59:17.130029+05:30",
        "start_time": "25:38:42",
        "end_time": "26:59:17",
        "quality": "inauspicious",
        "duration_minutes": 80.57,
        "index": 6
      },
      {
        "id": "chaughadia_night_7",
        "name": "Shoobh",
        "section": "night",
        "start": "2026-05-01T02:59:17.130029+05:30",
        "end": "2026-05-01T04:19:51.390053+05:30",
        "start_time": "26:59:17",
        "end_time": "28:19:51",
        "quality": "auspicious",
        "duration_minutes": 80.57,
        "index": 7
      },
      {
        "id": "chaughadia_night_8",
        "name": "Amrut",
        "section": "night",
        "start": "2026-05-01T04:19:51.390053+05:30",
        "end": "2026-05-01T05:40:25.650077+05:30",
        "start_time": "28:19:51",
        "end_time": "29:40:25",
        "quality": "auspicious",
        "duration_minutes": 80.57,
        "index": 8
      }
    ]
  },
  "periods": [
    {
      "id": "chaughadia_day_1",
      "name": "Shoobh",
      "section": "day",
      "start": "2026-04-30T05:41:17.026945+05:30",
      "end": "2026-04-30T07:20:36.344813+05:30",
      "start_time": "05:41:17",
      "end_time": "07:20:36",
      "quality": "auspicious",
      "duration_minutes": 99.32,
      "index": 1
    },
    {
      "id": "chaughadia_day_2",
      "name": "Rog",
      "section": "day",
      "start": "2026-04-30T07:20:36.344813+05:30",
      "end": "2026-04-30T08:59:55.662681+05:30",
      "start_time": "07:20:36",
      "end_time": "08:59:55",
      "quality": "inauspicious",
      "duration_minutes": 99.32,
      "index": 2
    },
    {
      "id": "chaughadia_day_3",
      "name": "Udveg",
      "section": "day",
      "start": "2026-04-30T08:59:55.662681+05:30",
      "end": "2026-04-30T10:39:14.980549+05:30",
      "start_time": "08:59:55",
      "end_time": "10:39:14",
      "quality": "inauspicious",
      "duration_minutes": 99.32,
      "index": 3
    },
    {
      "id": "chaughadia_day_4",
      "name": "Chal",
      "section": "day",
      "start": "2026-04-30T10:39:14.980549+05:30",
      "end": "2026-04-30T12:18:34.298417+05:30",
      "start_time": "10:39:14",
      "end_time": "12:18:34",
      "quality": "good",
      "duration_minutes": 99.32,
      "index": 4
    },
    {
      "id": "chaughadia_day_5",
      "name": "Laabh",
      "section": "day",
      "start": "2026-04-30T12:18:34.298417+05:30",
      "end": "2026-04-30T13:57:53.616285+05:30",
      "start_time": "12:18:34",
      "end_time": "13:57:53",
      "quality": "auspicious",
      "duration_minutes": 99.32,
      "index": 5
    },
    {
      "id": "chaughadia_day_6",
      "name": "Amrut",
      "section": "day",
      "start": "2026-04-30T13:57:53.616285+05:30",
      "end": "2026-04-30T15:37:12.934153+05:30",
      "start_time": "13:57:53",
      "end_time": "15:37:12",
      "quality": "auspicious",
      "duration_minutes": 99.32,
      "index": 6
    },
    {
      "id": "chaughadia_day_7",
      "name": "Kaal",
      "section": "day",
      "start": "2026-04-30T15:37:12.934153+05:30",
      "end": "2026-04-30T17:16:32.252021+05:30",
      "start_time": "15:37:12",
      "end_time": "17:16:32",
      "quality": "inauspicious",
      "duration_minutes": 99.32,
      "index": 7
    },
    {
      "id": "chaughadia_day_8",
      "name": "Shoobh",
      "section": "day",
      "start": "2026-04-30T17:16:32.252021+05:30",
      "end": "2026-04-30T18:55:51.569889+05:30",
      "start_time": "17:16:32",
      "end_time": "18:55:51",
      "quality": "auspicious",
      "duration_minutes": 99.32,
      "index": 8
    },
    {
      "id": "chaughadia_night_1",
      "name": "Amrut",
      "section": "night",
      "start": "2026-04-30T18:55:51.569885+05:30",
      "end": "2026-04-30T20:16:25.829909+05:30",
      "start_time": "18:55:51",
      "end_time": "20:16:25",
      "quality": "auspicious",
      "duration_minutes": 80.57,
      "index": 1
    },
    {
      "id": "chaughadia_night_2",
      "name": "Chal",
      "section": "night",
      "start": "2026-04-30T20:16:25.829909+05:30",
      "end": "2026-04-30T21:37:00.089933+05:30",
      "start_time": "20:16:25",
      "end_time": "21:37:00",
      "quality": "good",
      "duration_minutes": 80.57,
      "index": 2
    },
    {
      "id": "chaughadia_night_3",
      "name": "Rog",
      "section": "night",
      "start": "2026-04-30T21:37:00.089933+05:30",
      "end": "2026-04-30T22:57:34.349957+05:30",
      "start_time": "21:37:00",
      "end_time": "22:57:34",
      "quality": "inauspicious",
      "duration_minutes": 80.57,
      "index": 3
    },
    {
      "id": "chaughadia_night_4",
      "name": "Kaal",
      "section": "night",
      "start": "2026-04-30T22:57:34.349957+05:30",
      "end": "2026-05-01T00:18:08.609981+05:30",
      "start_time": "22:57:34",
      "end_time": "24:18:08",
      "quality": "inauspicious",
      "duration_minutes": 80.57,
      "index": 4
    },
    {
      "id": "chaughadia_night_5",
      "name": "Laabh",
      "section": "night",
      "start": "2026-05-01T00:18:08.609981+05:30",
      "end": "2026-05-01T01:38:42.870005+05:30",
      "start_time": "24:18:08",
      "end_time": "25:38:42",
      "quality": "auspicious",
      "duration_minutes": 80.57,
      "index": 5
    },
    {
      "id": "chaughadia_night_6",
      "name": "Udveg",
      "section": "night",
      "start": "2026-05-01T01:38:42.870005+05:30",
      "end": "2026-05-01T02:59:17.130029+05:30",
      "start_time": "25:38:42",
      "end_time": "26:59:17",
      "quality": "inauspicious",
      "duration_minutes": 80.57,
      "index": 6
    },
    {
      "id": "chaughadia_night_7",
      "name": "Shoobh",
      "section": "night",
      "start": "2026-05-01T02:59:17.130029+05:30",
      "end": "2026-05-01T04:19:51.390053+05:30",
      "start_time": "26:59:17",
      "end_time": "28:19:51",
      "quality": "auspicious",
      "duration_minutes": 80.57,
      "index": 7
    },
    {
      "id": "chaughadia_night_8",
      "name": "Amrut",
      "section": "night",
      "start": "2026-05-01T04:19:51.390053+05:30",
      "end": "2026-05-01T05:40:25.650077+05:30",
      "start_time": "28:19:51",
      "end_time": "29:40:25",
      "quality": "auspicious",
      "duration_minutes": 80.57,
      "index": 8
    }
  ],
  "warnings": [],
  "panchang_context": {
    "sunrise": "05:41:17",
    "sunset": "18:55:51",
    "weekday": {
      "number": 5,
      "name": "Thursday"
    },
    "rahu_kalam": {
      "start": "13:57",
      "end": "15:37"
    }
  },
  "supported_questions": [
    "abhijit_muhurat_today",
    "rahu_kaal_today",
    "brahma_muhurat",
    "do_ghati_muhurat",
    "hora",
    "chaughadia",
    "gowri_panchangam",
    "panchak_today",
    "bhadra_today"
  ],
  "metadata": {
    "endpoint_version": "v2",
    "ruleset_version": "astrosage_daily_muhurat_qa_v1",
    "ayanamsha": "lahiri",
    "timezone_used": "Asia/Kolkata",
    "calculation_basis": "day_and_night_each_split_into_8_chaughadia_periods",
    "calculation_notes": [
      "Full day/night table output is deterministic from sunrise/sunset and fixed weekday ordering conventions."
    ]
  }
}

FAQ

Does this endpoint support custom questions?

No. The endpoint is officially constrained to supported daily Vedic Muhurat topic phrases: Abhijit Muhurat, Rahu Kaal, Brahma Muhurat, Do Ghati, Hora, Chaughadia, Gowri Panchangam, Panchak, and Bhadra. Unsupported text returns 400 instead of a guessed answer.

How is the current period selected?

If you send time as HH:MM or HH:MM:SS, the endpoint resolves the period active at that local wall time. If time is omitted for today, it uses the current local time for the resolved location; for past or future dates, current_period is null.

Should developers send tz_str?

Usually no. When lat and lng are provided, omit tz_str and the API resolves the timezone automatically. Send tz_str only when you need to override timezone detection, reproduce a calibration run exactly, or use a special mode such as LMT.

What should astrologers know about the rules?

The endpoint uses the Vedic sunrise and sunset engine, weekday-specific Rahu Kaal mapping, day/night divisions for Hora, Chaughadia, Gowri, and Do Ghati, and Panchang-derived Panchak and Bhadra periods. Metadata exposes the calculation basis so the result can be audited.

Related Docs