Public Conversion API

Drop-in REST API for BS↔AD conversion. 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'

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.