/api/astro/monthly_panchang/1 кредитМісячний панчанг
Один рядок на кожен календарний день цілого григоріанського місяця — та сама сітка, що й у друкованому настінному календарі-панчангу. Для кожного дня є схід і захід Сонця, схід і захід Місяця, день тижня санскритом, місячний місяць за обома системами ліку, роки Вікрам і Шака з назвами шістдесятирічного циклу, а також тітхі, знак Місяця й накшатра Місяця, чинні на момент сходу Сонця цього дня. Тітхі чи накшатра зазвичай змінюється посеред дня, тож кожен із цих трьох показників має exit_time: точний момент, коли він змінюється наступним, або null, якщо він триває й після наступного сходу Сонця. Саме це дає змогу показувати звичні мітки на кшталт 'Vrishchika 01:08+'. Передайте year, month, latitude, longitude і зміщення від UTC. moon_option визначає, за якою системою ліку заповнюється поле lunar_month: 'purnimanta' (за замовчуванням) чи 'amanta'. amanta_month і purnimanta_month повертаються в кожному рядку за будь-якого вибору, тож перемкнути подання можна без повторного виклику. Відповідь — {year, month, days}, по одному запису на кожен день місяця.
https://api.occultapi.com/api/astro/monthly_panchang/
Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. |
| month | integer | обов’язковий | Місяць народження числом від 1 до 12; січень — 1. min 1 · max 12 |
| timezone_as_float | number (double) | обов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. |
| year | integer | обов’язковий | Рік народження числом, напр. 1990. Чотири цифри. min 1800 · max 2400 |
| moon_option | string | необов’язковий | purnimantaamanta |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/monthly_panchang/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"month":9,"timezone_as_float":5.5,"year":2026,"moon_option":"purnimanta"}'Відповідь
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"month\": 9, \"days\": [{\"date\": \"2026-09-01\", \"vaara\": \"Mangalavara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-01T06:09:56+05:30\", \"sunset\": \"2026-09-01T18:43:30+05:30\", \"moonrise\": \"2026-09-01T21:09:00+05:30\", \"moonset\": \"2026-09-01T09:53:10+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Chaturthi\", \"exit_time\": \"2026-09-01T07:42:57+05:30\"}, \"moon_rashi\": {\"name\": \"Mesha\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Ashwini\", \"exit_time\": \"2026-09-02T02:42:25+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-02\", \"vaara\": \"Budhavara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-02T06:10:22+05:30\", \"sunset\": \"2026-09-02T18:42:26+05:30\", \"moonrise\": \"2026-09-02T21:50:26+05:30\", \"moonset\": \"2026-09-02T10:57:09+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Panchami\", \"exit_time\": \"2026-09-02T06:13:35+05:30\"}, \"moon_rashi\": {\"name\": \"Mesha\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Bharani\", \"exit_time\": \"2026-09-03T01:43:16+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-03\", \"vaara\": \"Guruvara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-03T06:10:48+05:30\", \"sunset\": \"2026-09-03T18:41:21+05:30\", \"moonrise\": \"2026-09-03T22:38:43+05:30\", \"moonset\": \"2026-09-03T12:03:39+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Saptami\", \"exit_time\": \"2026-09-04T02:26:25+05:30\"}, \"moon_rashi\": {\"name\": \"Mesha\", \"exit_time\": \"2026-09-03T07:26:05+05:30\"}, \"moon_nakshatra\": {\"name\": \"Krittika\", \"exit_time\": \"2026-09-04T00:29:36+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-04\", \"vaara\": \"Shukravara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-04T06:11:14+05:30\", \"sunset\": \"2026-09-04T18:40:15+05:30\", \"moonrise\": \"2026-09-04T23:34:48+05:30\", \"moonset\": \"2026-09-04T13:10:53+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Ashtami\", \"exit_time\": \"2026-09-05T00:14:34+05:30\"}, \"moon_rashi\": {\"name\": \"Vrishabha\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Rohini\", \"exit_time\": \"2026-09-04T23:04:27+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-05\", \"vaara\": \"Shanivara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-05T06:11:40+05:30\", \"sunset\": \"2026-09-05T18:39:09+05:30\", \"moonrise\": \"2026-09-06T00:38:03+05:30\", \"moonset\": \"2026-09-05T14:15:49+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Navami\", \"exit_time\": \"2026-09-05T21:54:40+05:30\"}, \"moon_rashi\": {\"name\": \"Vrishabha\", \"exit_time\": \"2026-09-05T10:18:34+05:30\"}, \"moon_nakshatra\": {\"name\": \"Mrigasira\", \"exit_time\": \"2026-09-05T21:31:03+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-06\", \"vaara\": \"Ravivara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-06T06:12:06+05:30\", \"sunset\": \"2026-09-06T18:38:03+05:30\", \"moonrise\": \"2026-09-07T01:45:53+05:30\", \"moonset\": \"2026-09-06T15:15:16+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Dashami\", \"exit_time\": \"2026-09-06T19:30:12+05:30\"}, \"moon_rashi\": {\"name\": \"Mithuna\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Aardra\", \"exit_time\": \"2026-09-06T19:52:"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.