/api/astro/nepali_calendar/1 creditNepali calendar
A year of Nepali festivals and observances on the Bikram Sambat calendar. The Nepali calendar is solar — twelve months each opening with the Sun's entry into a sidereal sign, Baishakh first — and the response reports the Bikram Sambat year or year-pair spanning the Gregorian year you asked for. The event list covers every Sankranti under its Nepali name (Maghe, Falgun, Baishakh and so on), all the Ekadashis, both Pradosh Vrats of each month named for their weekday, the eclipses, and national festivals such as Nawa Barsha and Bisket Jatra. Pass year with latitude, longitude and UTC offset — and note that Nepal Standard Time is UTC+05:45, so timezone_as_float should be 5.75 for Kathmandu; 5.5 will shift the day boundaries. The response is {year, bikram_sambat, events} with each event {name, date}. The year must be between 2006 and 2046. The month-start rule follows the practice of dating a Sankranti on the transit day when the transit occurs before that day's sunset and on the following day otherwise. Nepal's official month starts are set by committee rather than derived from a single astronomical test, so a small number of transits each decade will not match the published Patro.
https://yogataraapi.prahlad.app/api/astro/nepali_calendar/Authentication
Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonRequest fields
| Field | Type | Required | Notes |
|---|---|---|---|
| latitude | number (double) | required | Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first. |
| longitude | number (double) | required | Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China. |
| timezone_as_float | number (double) | required | UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30), -5 for New York in winter, 5.75 for Nepal. This is NOT validated against date_time - if the two disagree you get a successful response for the wrong moment, so derive both from the same source. Use the offset in force on that date, not today's: a summer birth in a country with daylight saving needs the summer offset. |
| year | integer | required | Year of birth as a number, e.g. 1990. Four digits. min 2006 · max 2046 |
Example request
curl -X POST https://yogataraapi.prahlad.app/api/astro/nepali_calendar/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'Response
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"bikram_sambat\": \"2082 - 2083\", \"events\": [{\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-01-01\"}, {\"name\": \"Maghe Sankranti\", \"date\": \"2026-01-14\"}, {\"name\": \"Sat-Tila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-16\"}, {\"name\": \"Shree Panchami\", \"date\": \"2026-01-23\"}, {\"name\": \"Bhima Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-30\"}, {\"name\": \"Falgun Sankranti\", \"date\": \"2026-02-13\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-02-14\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Surya Grahan *Valayakara\", \"date\": \"2026-02-17\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-03-01\"}, {\"name\": \"Chandra Grahan *Purna\", \"date\": \"2026-03-03\"}, {\"name\": \"Fagu Poornima\", \"date\": \"2026-03-03\"}, {\"name\": \"Chaitra Sankranti\", \"date\": \"2026-03-15\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-16\"}, {\"name\": \"Ram Nawami\", \"date\": \"2026-03-26\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-30\"}, {\"name\": \"Hanuman Jayenti\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Janmotsava\", \"date\": \"2026-04-02\"}, {\"name\": \"Baruthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Baishakh Sankranti\", \"date\": \"2026-04-14\"}, {\"name\": \"Nawa Barsha\", \"date\": \"2026-04-14\"}, {\"name\": \"Bisket Jatra\", \"date\": \"2026-04-14\"}, {\"name\": \"Budha Pradosh Vrat\", \"date\": \"2026-04-15\"}, {\"name\": \"Parasuram Jayenti\", \"date\": \"2026-04-19\"}, {\"name\": \"Aachya Tritiya\", \"date\": \"2026-04-20\"}, {\"name\": \"Sita Jayanti\", \"date\": \"2026-04-25\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-04-28\"}, {\"name\": \"Buddha Jayanti\", \"date\": \"2026-05-01\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-14\"}, {\"name\": \"Jeshta Sankranti\", \"date\": \"2026-05-15\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-28\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-06-12\"}, {\"name\": \"Asar Sankranti\", \"date\": \"2026-06-15\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-06-27\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-12\"}, {\"name\": \"Shrawane Sankranti\", \"date\": \"2026-07-17\"}, {\"name\": \"Harisayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-26\"}, {\"name\": \"Kamika Ekadashi\", \"date\": \"2026-08-09\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-08-10\"}, {\"name\": \"Surya Grahan *Purna\", \"date\": \"2026-08-12\"}, {\"name\": \"Bhadra Sankranti\", \"date\": \"2026-08-17\"}, {\"name\": \"Putrada Ekadashi\", \"date\": \"2026-08-23\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-08-25\"}, {\"name\": \"Chandra Grahan *Anshika\", \"date\": \"2026-08-28\"}, {\"name\": \"Janai Purnima\", \"date\": \"2026-08-28\"}, {\"name\": \"Kwati Punhi\", \"date\": \"2026-08-28\"}, {\"name\": \"Rakshya Bandhan\", \"date\": \"2026-08-28\"}, {\"name\": \"Gai Jatra\", \"date\": \"2026-08-29\"}, {\"name\": \"Shree Krishna Janmastami\", \"date\": \"2026-09-04\"}, {\"name\": \"Aja Ekadashi\", \"date\": \"2026-09-07\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-09-08\"}, {\"name\": \"Hartalika Teej\", \"date\": \"2026-09-14\"}, {\"name\": \"Ganesh Chaturthi\", \"date\": \"2026-09-14\"}, {\"name\": \"Rishi Panchami\", \"date\": \"2026-09-15\"}, {\"name\": \"Ashoj Sankranti\", \"date\": \"2026-09-17\"}, {\"name\": \"Bishwakarma Pooja\", \"date\": \"2026-09-17\"}, {\"name\": \"Radhastami\", \"date\": \"2026-09-19\"}, {\"name\": \"Hari-Parivartan Ekadashi\", \"date\": \"2026-09-22\"}, {\"name\": \"Indra Jatra\", \"date\": \"2026-09-23\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-09-24\"}, {\"name\": \"Pitrupaksha Arambha\", \"date\": \"2026-09-27\"}, {\"name\": \"Pratiprada Shradham\", \"date\": \"2026-09-27\"}, {\"name\": \"Indira Ekadashi\", \"date\": \"2026-10-06\"}, {\"name\": \"Guru "
}Captured from a real call using the exact request above. Results sit under data.
Errors
Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.