Calendar API

A Nepali calendar for your backend.

Convert BS and AD, build month grids and get the daily panchang for any place. Every response names its data versions, so each change can be traced.

Get API key Read the docs

Endpoints

GET/v1/calendar/convert
BS and AD conversion
1 credit
GET/v1/calendar/month
Month grid with tithi
1 credit
GET/v1/panchang/day
Daily panchang and choghadiya
1 credit
GET/v1/panchang/range
Up to 366 days
1 credit per 31 days
GET/v1/timezone
Timezone and offset for a place and instant
1 credit

Conversion with a status you can trust

Years the Panchang Samiti has published return bsStatus "published". Every other year from BS 1970 to 2100 is "projected", so you always know which dates may still move.

GET /v1/calendar/convert?date=2082-01-01&calendar=BS&include=nepalSambat

{
  "ad": {
    "date": "2025-04-14",
    "year": 2025,
    "month": 4,
    "day": 14,
    "weekday": { "index": 1, "name": "Monday" }
  },
  "bs": {
    "date": "2082-01-01",
    "year": 2082,
    "month": { "index": 1, "name": "Baishakh" },
    "day": 1,
    "status": "published",
    "text": "1 Baishakh 2082"
  },
  "nepalSambat": {
    "year": 1145,
    "month": { "index": 6, "name": "Chaula" },
    "paksha": { "index": 2, "name": "Ga" },
    "day": 1,
    "adhik": false,
    "text": "1145 Chaula Ga 1"
  },
  "meta": { "bsTableVersion": "2026.10.1", "apiVersion": "2026-11-01" }
}

Daily panchang for any place

Tithi, nakshatra, yoga and karana, each with start and end
Paksha and lunar month, purnimanta or amanta, with an adhik flag
Sunrise, sunset, moonrise and moonset in local time and UTC
Eight day and eight night choghadiya periods
Samiti overrides flagged with overrideApplied

curl "https://api.navapatra.com/v1/panchang/day?date=2083-01-01&calendar=BS&lat=27.7172&lng=85.3240&lang=ne" \
  -H "Authorization: Bearer $NAVAPATRA_API_KEY" \
  -H "Navapatra-Version: 2026-11-01"

const params = new URLSearchParams({
  date: '2083-01-01', calendar: 'BS',
  lat: '27.7172', lng: '85.3240', lang: 'ne',
});

const res = await fetch(`https://api.navapatra.com/v1/panchang/day?${params}`, {
  headers: { Authorization: `Bearer ${process.env.NAVAPATRA_API_KEY}` },
});
const day = await res.json();

import os, requests

day = requests.get(
    "https://api.navapatra.com/v1/panchang/day",
    params={"date": "2083-01-01", "calendar": "BS",
            "lat": 27.7172, "lng": 85.3240, "lang": "ne"},
    headers={"Authorization": f"Bearer {os.environ['NAVAPATRA_API_KEY']}"},
).json()

<?php
$client = new GuzzleHttp\Client();

$res = $client->get('https://api.navapatra.com/v1/panchang/day', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('NAVAPATRA_API_KEY')],
    'query' => ['date' => '2083-01-01', 'calendar' => 'BS',
                'lat' => 27.7172, 'lng' => 85.3240, 'lang' => 'ne'],
]);

$day = json_decode($res->getBody(), true);

Response shape, values elided200 OK

{
  "date": "2026-04-14",
  "bs": {
    "date": "2083-01-01",
    "year": 2083,
    "month": { "index": 1, "name": "वैशाख" },
    "day": 1,
    "status": "published",
    "text": "१ वैशाख २०८३"
  },
  "tzid": "Asia/Kathmandu",
  "sunrise": { "utc": "2026-04-13T23:59:16Z", "local": "2026-04-14T05:44:16+05:45" },
  "sunset": { "utc": "2026-04-14T12:39:10Z", "local": "2026-04-14T18:24:10+05:45" },
  "vara": { "index": 2, "name": "मङ्गलबार" },
  "tithi": {
    "index": 27,
    "name": "द्वादशी",
    "start": "2026-04-13T19:39:07Z",
    "end": "2026-04-14T18:42:48Z",
    "paksha": { "id": "krishna", "index": 2, "name": "कृष्ण" }
  },
  "nakshatra": {
    "index": 24,
    "name": "शतभिषा",
    "start": "2026-04-13T10:33:43Z",
    "end": "2026-04-14T10:36:04Z"
  },
  "yoga": {
    "index": 24,
    "name": "शुक्ल",
    "start": "2026-04-13T11:46:42Z",
    "end": "2026-04-14T10:09:29Z"
  },
  "karana": {
    "index": 3,
    "name": "कौलव",
    "start": "2026-04-13T19:39:07Z",
    "end": "2026-04-14T07:16:51Z"
  },
  "lunarMonth": {
    "index": 1,
    "name": "वैशाख",
    "start": "2026-04-02T02:11:56Z",
    "end": "2026-05-01T17:23:05Z",
    "adhik": false,
    "scheme": "purnimanta"
  },
  "choghadiya": {
    "day": [
      {
        "period": 1,
        "id": "rog",
        "index": 7,
        "name": "रोग",
        "start": "2026-04-13T23:59:16Z",
        "end": "2026-04-14T01:34:16Z"
      }
    ],
    "night": [
      {
        "period": 1,
        "id": "kaal",
        "index": 5,
        "name": "काल",
        "start": "2026-04-14T12:39:10Z",
        "end": "2026-04-14T14:04:03Z"
      }
    ]
  },
  "meta": {
    "engineVersion": "0.1.0",
    "apiVersion": "2026-11-01",
    "ayanamsha": { "id": "lahiri", "degrees": 24.22586 },
    "tradition": "nepal",
    "sunriseConvention": "center_geometric",
    "tzdbVersion": "unknown",
    "bsTableVersion": "2026.10.1",
    "overridesVersion": null
  }
}

Holidays and festivals

The API does not return public holidays or festival dates. Holidays will be added only once their data source and reuse terms are settled. Month grids carry the BS and AD date and the tithi of each day.