Public Conversion API

Drop-in REST API for BS↔AD conversion, calendar grids, festivals and fiscal year. JSON responses, no API key required.

GET/api/convert/bs-to-ad?year=2082&month=1&day=15

Convert a Bikram Sambat date to Gregorian (AD)

curl 'https://npdates.org/api/convert/bs-to-ad?year=2082&month=1&day=15'

GET/api/convert/ad-to-bs?year=2025&month=4&day=28

Convert a Gregorian (AD) date to Bikram Sambat

curl 'https://npdates.org/api/convert/ad-to-bs?year=2025&month=4&day=28'

GET/api/today

Today's date in BS and AD (Asia/Kathmandu)

curl 'https://npdates.org/api/today'

GET/api/calendar/{year}/{month}

Full BS month grid with festivals and AD mappings

curl 'https://npdates.org/api/calendar/2082/6'

GET/api/festivals/{year}

Festivals and public holidays for a BS year

curl 'https://npdates.org/api/festivals/2082'

GET/api/fiscal-year/{year}

Nepal fiscal year window for a starting BS year

curl 'https://npdates.org/api/fiscal-year/2082'

Use it from JavaScript

const r = await fetch(
  "https://npdates.org/api/convert/bs-to-ad?year=2082&month=1&day=15"
);
const data = await r.json();
console.log(data.ad.formatted);
// => "April 28, 2025"

Rate limits

The free public API is rate-limited per IP. For higher-volume use, self-host the open spec or contact us for a partnership.

Stability

The response shape is versioned via the OpenAPI spec. We will not break existing fields; new fields may be added over time.