Developer documentation

Kundali, panchang and Nepali calendar data, over one REST API.

Charts, dashas, guna milan, daily panchang and Bikram Sambat dates in English, Nepali and Hindi, for apps in Nepal and India. Every response names the conventions behind it, so you can check the numbers.

Quickstart API reference

Base URL: https://api.navapatra.com/v1
Navapatra-Version: 2026-11-01
Demo key: demo

curl https://api.navapatra.com/v1/kundali \
  -H "Authorization: Bearer demo" \
  -H "Content-Type: application/json" \
  -d '{"birth": {"calendar": "BS", "date": "2050-05-12",
       "time": "14:35", "place": {"lat": 28.2096, "lng": 83.9856}}}'

{
  "subject": {
    "instantUtc": "1993-08-28T08:50:00Z",
    "tzid": "Asia/Kathmandu", "utcOffset": "+05:45",
    "birth": { "ad": "1993-08-28", "bs": "2050-05-12" }
  },
  "lagna": { "sign": { "index": 9, "name": "Dhanu" }, "pada": 2 },
  "moon": { "nakshatra": { "index": 21, "name": "Uttara Ashadha" } },
  "meta": { "ayanamsha": { "id": "lahiri", "degrees": 23.773159 } }
}

Navapatra is a JSON API at https://api.navapatra.com/v1. Send Authorization: Bearer <key>, get JSON back. Start with the public demo key: it needs no signup and works for five bundled sample births.

Start here

QuickstartMake a real call in a minute with the demo key, in curl, TypeScript, Python or PHP.

Authentication and keysSecret, test, publishable and client-token keys, and when to use each.

Mobile appsKeep secret keys on your server and hand short-lived tokens to the app.

ConventionsFive ayanamshas, node type, sunrise and tradition, and what meta echoes back.

Build

KundaliD1, D9 and all vargas, nakshatra and pada, birth panchang and sensitivity flags.

DashasVimshottari, Yogini and Tribhagi timelines to three levels, with asOf.

MatchingAshtakoota guna milan for one pair or a hundred, and rashi compatibility.

Panchang and calendarDaily panchang anywhere, choghadiya, BS month grids and Nepal Sambat.

Bikram Sambat datesConvert between BS and AD, and what published and projected mean.

Charts and SVG themingNorth and South Indian charts you can theme with CSS variables.

Run it in production

Credits and meteringWhat costs a credit, the monthly free grant and how lots are spent.

ErrorsEvery error code the API returns, with its status and the fix.

VersioningDated versions, pinning and why data updates are not pinned.

AccuracyHow the engine is tested against Swiss Ephemeris, the latest results and the public corpus.

For AI tools

Every page is also plain Markdown: add .md to its path, for example /quickstart.md. llms.txt lists them all and llms-full.txt has the whole site in one file, including the API reference.