Vedic Daily Muhurat Lookup
Vedic Daily Muhurat Lookup
/api/v2/vedic/qaLook 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/qaSafe 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.
Response Shape
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.
{
"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.