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 in English or Hindi, or a supported intent key. The input text is echoed unchanged. 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: "en" (English, default) or "hi" (Hindi). Codes are case-insensitive. Translates answers, display names, warnings and calculation notes. Unsupported values return 422.
Field
lang
Type
string
Required
No
Description
Alias for language, matching the Panchang endpoint. If both are supplied, they must agree after case normalization; conflicts return 422.

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
periods[].quality_label
Type
string
Required
n/a
Description
Hindi display label for quality when language="hi". The quality code stays unchanged. Display labels also appear in period, muhurat, current_period and sections where applicable, and are omitted in English.
Field
periods[].section_label
Type
string
Required
n/a
Description
Hindi display label for the section; section and the keys of sections stay unchanged.
Field
periods[].planet_label
Type
string
Required
n/a
Description
Hindi planet name for Hora. The planet value keeps its existing identifier, such as Sun or Jupiter.
Field
warnings
Type
array[string]
Required
n/a
Description
Traditional cautions in the selected language. Calculation notes are localized too; machine metadata stays unchanged.
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

V2

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

{
  "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
  },
  "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": [
      "Chaughadia divides daytime and nighttime into eight equal periods each, with separate weekday-specific name sequences."
    ]
  }
}

Related Docs

PanchangMuhurat search

FAQ

Can I use the daily Muhurat lookup in Hindi?

Yes. Send "lang": "hi" or "language": "hi" for Hindi answers, names, warnings and calculation notes. For example, use "question": "आज का चौघड़िया बताइए।". English topic names and supported intent keys work too. The question is echoed unchanged, while intent IDs, section keys, quality codes, planet identifiers and times stay stable. Hindi display labels accompany those codes. This applies to /qa; Muhurat search endpoints remain English-only. Error messages remain in English.

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. Send one topic per request. Unsupported text or multiple different topics return 400, including questions mixing Hindi and English.

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, supply time for a lookup. Day/night tables begin at the requested date’s sunrise, so earlier times have no matching period. current_period is omitted when no period is resolved. Hindi Hora summaries describe the resolved lookup period when available.

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. If required sunrise or sunset events are unavailable, the endpoint returns 422 with detail.code set to sunrise_unavailable or sunset_unavailable.