Checking API…

The Nepali calendar,
ready for every app.

Convert between Bikram Sambat (BS) and AD, show holidays and events, and give your website and mobile app a date picker whose colours and defaults you control from one admin dashboard.

Convert a date Read the docs

BS ⇄ AD date converter

Pick a date in either calendar. Covers every year in the calendar table.

Choose a date and press convert.

Calendar

Browse any month, past or future, with holidays and events. Click a day to convert it.

…

What it does

BS ⇄ AD conversion

Exact conversion from an official year table covering BS 1975–2100. Month grids come ready to render, with both dates in every cell.

Holidays and events

Admins add festivals, public holidays and events on BS or AD dates, including yearly repeats. Apps only see what is published.

Theme from the dashboard

Colours for light and dark mode, the default calendar (BS or AD), language and digits are set in the dashboard. No app release needed.

Web and mobile

One API for React and Next.js websites and React Native apps. Data is cached on the device, so the calendar works offline.

Safe changes

Year-table changes need a second admin's approval. Theme changes can roll out to a percentage of users first and roll back in one click.

Built to stay up

Versioned, cacheable responses, API keys with rate limits, an audit log of every change, webhooks and daily database backups.

How it works

Admins manage the calendar. In the dashboard they add events and holidays, keep the BS year table correct, and design the date picker theme.
The API publishes versions. Each change gets a new version number. The manifest tells apps what changed.
Apps sync and cache. Your website or app checks the manifest, downloads only what changed, and renders the calendar from its cache.

Quick start

Ask an admin for an API key, then send it in the X-Api-Key header. Every endpoint is under /api.

# Today in both calendars
curl -H "X-Api-Key: pk_your_key" /api/v1/today

# Convert an AD date to BS (or use ?bs=2083-06-08)
curl -H "X-Api-Key: pk_your_key" "/api/v1/convert?ad=2026-10-02"

# A ready-to-render BS month with its events
curl -H "X-Api-Key: pk_your_key" /api/v1/months/BS/2083/6

const API = "/api";
const headers = { "X-Api-Key": "pk_your_key" };

const today = await fetch(`${API}/v1/today`, { headers }).then((r) => r.json());
console.log(today.bs.date, today.bs.monthName.ne); // "2083-06-16" "असोज"

const month = await fetch(`${API}/v1/months/BS/2083/6`, { headers }).then((r) => r.json());
month.cells.forEach((c) => console.log(c.bs, c.ad, c.isHoliday));

// Same API from React Native. Cache the manifest and data (see docs/react-native.md).
const API = "/api";

export async function getToday() {
  const res = await fetch(`${API}/v1/today?tz=Asia/Kathmandu`, {
    headers: { "X-Api-Key": "pk_your_mobile_key" },
  });
  if (!res.ok) throw new Error(`Calendar API ${res.status}`);
  return res.json();
}

Main endpoints

Endpoint	What it returns
`GET /api/v1/today`	Today in BS and AD, with weekday and month names in English and Nepali
`GET /api/v1/convert?ad=… \| ?bs=…`	One date converted between the calendars
`GET /api/v1/months/{BS\|AD}/{year}/{month}`	A 42-cell month grid with holidays and events
`GET /api/v1/events?from=…&to=…`	Published events in a date range
`GET /api/v1/categories`	Event categories, colours and holiday flags
`GET /api/v1/manifest?app=web`	Current versions of the year table, theme and events, for caching apps
`GET /api/v1/events.ics?api_key=…`	A calendar feed for Google Calendar, Outlook or Apple Calendar

Integration guides for React, Next.js and React Native are in the docs; every endpoint is in the API reference.

Developer docsGuides and React, Next.js and React Native integration API referenceEvery endpoint, parameter and error code Admin dashboardEvents, holidays, theme, keys and users