Drik & Sūrya-siddhānta Panchanga API

Version 1.1.3 · JSON over HTTP · two engines · sunrise-based Vedic pañcāṅga

ReDoc Swagger Catalog openapi.json Mobile pack

Same fields as tantragurukul.org/panchanga. Default place is Dehradun (30.3165, 78.0322, 600 m, IST +5.5).

Authentication

Without a key, JSON returns only tithi, nakṣatra, yoga, karaṇa, vāra, sunrise/sunset, and spaṣṭa grahas. Kundali, muhūrta, saṅkrānti, kala/range, dashas, and the full display payload need a paid key. See Drik-API License 1.0.

X-API-Key: your-secret

Local testing (this machine only): key drik-test-local unlocks commercial routes. On localhost / 127.0.0.1 those routes also work with no header. The same key is accepted as a query so a browser URL works:

curl -H 'X-API-Key: drik-test-local'   'http://127.0.0.1:8088/v1/vedic/sade-sati?date=1990-05-15&time=14:30&place=Delhi'

http://127.0.0.1:8088/v1/vedic/sade-sati?date=1990-05-15&time=14:30&place=Delhi&api_key=drik-test-local

That test key is rejected on the public host. Create a free account and generate a key on the dashboard. Plans are priced in API credits (a tithi call is 1; Shadbala or kundali/full is 5). Free Basic ₹0 (1,000 credits / month), Developer ₹499 / year (10,000), Pro ₹1,499 / year (100,000, non-commercial), Commercial ₹4,999 / year (1,000,000 credits, reasonable use), Enterprise from ₹21,000 / year (unlimited credits). Paid plans are activated after payment. Over the cap returns HTTP 429.

Common parameters

ParamDefaultNotes
datetoday ISTYYYY-MM-DD
timesunriseOmit for sunrise; else local HH:MM
placeदेहरादूनName, district, or coordinates
latitude longitude30.3165, 78.0322Dehradun
tz5.5Hours east of UTC

Mobile kundali pack

TantraGurukul’s own app (and any Enterprise client) uses one call for the first kundali screen: printable HTML, natal JSON, and ready URLs for every follow-up API. Enterprise / unlimited key only (from ₹21,000 / year). The env key name is app — app:unlimited:<secret> in .env. Do not put that secret in this public page; keep it in the app’s private config or a small backend proxy.

Prefer raw HTML for WebView:

X-API-Key: YOUR-APP-KEY

GET /v1/vedic/kundali-book.html?date=1990-05-15&time=14:30&place=दिल्ली&name=राम&white_label=1&brand_name=तंत्रकुलज्योतिषम्

Or JSON pack (HTML string + natal + calls). PDF is not in the pack — print the HTML on the phone. Same flags as this API: HTML → PDF instructions.

GET /v1/vedic/kundali-pack?date=1990-05-15&time=14:30&place=दिल्ली&name=राम&white_label=1&brand_name=तंत्रकुलज्योतिषम्

Local UI work: drik-test-local on localhost only. The mobile:basic env key is Free Basic — it will 403 this route. Sūrya engine: /v1/surya/kundali-book.html and /v1/surya/kundali-pack.

ParamRequiredNotes
date time placeYesBirth civil date, clock, place (or lat/lon/tz)
nameNoCover name
white_labelNo1 = own brand, no watermark
brand_nameIf white-labelCover title, e.g. तंत्रकुलज्योतिषम्
brand_kicker brand_tagline brand_footNoCover lines
brand_logoNohttps URL of a square logo
girl_date (and girl_*)NoAdds the matching chapter
include_pdfNoPack only: 1 adds pdf_base64 (server Chrome)
saveNo1 stores this chart for Ask and returns native_id
native_keyNoApp’s kundali row id; upserts the same person

JSON 200 from kundali-pack (same key then works on every URL in calls):

{
  "success": true,
  "engine": "drik",
  "plan": "unlimited",
  "html": "<!DOCTYPE html>…",
  "html_filename": "kundali-राम-1990-05-15-drik-….html",
  "natal": { "date": {}, "planets": {}, "dashas": {}, "tithi": {}, "nakshatra": {} },
  "calls": {
    "planets": "/v1/vedic/planets?date=1990-05-15&time=14:30&place=…",
    "dashas": "/v1/vedic/dashas?…",
    "career-report": "/v1/vedic/career-report?…",
    "kundali-book.html": "/v1/vedic/kundali-book.html?…",
    "kundali-book.pdf": "/v1/vedic/kundali-book.pdf?…"
  },
  "white_label": true,
  "pdf_howto": "/docs/kundali-html-to-pdf.md"
}

App wiring. Timeout 60s for HTML / pack. Store the key in secure storage, never in git. Load HTML in a WebView (kundali-book.html as a document, or pack.html via loadHtmlString). Paint the first chart from natal.planets / natal.dashas. Extra tabs GET the matching calls URL with the same X-API-Key. Share/save PDF: follow HTML → PDF (Chrome flags or WKWebView / Android print). Server PDF only if you pass include_pdf=1 or GET kundali-book.pdf.

Save for Ask. When the app builds a kundali here, persist it on this API and ask against that id — do not send birth fields again:

GET /v1/vedic/kundali-pack?date=…&time=…&place=…&name=राम&save=1&native_key=user42-self
→ native_id, native_key

POST /v1/ask
{ "question": "मेरी नौकरी कब बदल सकती है?", "native_id": 12, "language": "hi" }
# or { "question": "…", "native_key": "user42-self" }
curl -H 'X-API-Key: YOUR-APP-KEY'   'https://astro.tantragurukul.org/v1/vedic/kundali-book.html?date=1990-05-15&time=14:30&place=दिल्ली&name=राम&white_label=1&brand_name=तंत्रकुलज्योतिषम्'
curl -H 'X-API-Key: YOUR-APP-KEY'   'https://astro.tantragurukul.org/v1/vedic/kundali-pack?date=1990-05-15&time=14:30&place=दिल्ली&name=राम&white_label=1&brand_name=तंत्रकुलज्योतिषम्'
const r = await fetch(
  'https://astro.tantragurukul.org/v1/vedic/kundali-pack?' +
    new URLSearchParams({
      date: '1990-05-15', time: '14:30', place: 'दिल्ली',
      name: 'राम', white_label: '1', brand_name: 'तंत्रकुलज्योतिषम्',
    }),
  { headers: { 'X-API-Key': APP_KEY } },
);
const pack = await r.json();
// pack.html → WebView
// fetch(origin + pack.calls.dashas, { headers: { 'X-API-Key': APP_KEY } })
final uri = Uri.https('astro.tantragurukul.org', '/v1/vedic/kundali-pack', {
  'date': date, 'time': time, 'place': place, 'name': name,
  'white_label': '1', 'brand_name': 'तंत्रकुलज्योतिषम्',
});
final res = await http.get(uri, headers: {'X-API-Key': appKey});
final pack = jsonDecode(utf8.decode(res.bodyBytes));

Vedic routes

Catalog: GET /v1/vedic. Birth-chart routes need time. Matching uses boy_* and girl_* fields.

Panchanga

/v1/vedic/panchanga · tithi · nakshatra · yoga · karana · calendar · rise-set · sankranti · grahan · sankalpa · bhadra · muhurta · hora · chaughadiya · karya-muhurta · special-yogas

Kārya-muhūrta

/v1/vedic/karya-muhurta — pick karya first (gṛha-praveśa, bhūmi-pūjan, vyavasāya, yātrā, nāmakaraṇa, vāhana, vidyārambha, pūjā, śalya). Vivāha is listed, not computed. Rules from Muhūrta-cintāmaṇi (core) and Dharmasindhu / Nirṇayasindhu (saṃskāra). Each row cites a prakaraṇa — no invented śloka. Optional days=1..31, yātrā direction=, gṛha-praveśa kind=nava|jirna|both (Muhūrta-cintāmaṇi 13), span=year for the Gregorian year of date. Sūrya: /v1/surya/karya-muhurta.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/karya-muhurta?karya=griha_pravesha&date=2027-01-01&place=दिल्ली&span=year'

Saṃhitā / mundane year

/v1/vedic/samvatsara — rājā from Caitra śukla pratipadā weekday (living pañcāṅga), Grahavarṣapati from Caitra amāvasyā (older / alternate school), mantrī (Meṣa weekday), both ingress charts, eclipses, close graha meetings, Rohiṇī / Svāti / Āṣāḍha dates. Admin, Enterprise, and the first-party mobile API only — not on Examples. Default place is New Delhi unless place or coordinates are sent. Not natal Tājika varṣaphala. Sūrya: /v1/surya/samvatsara.

Festivals

/v1/vedic/festivals · /v1/vedic/festivals/deepavali · /v1/vedic/festivals/dhanteras · /v1/vedic/festivals/narakachaturdashi · /v1/vedic/festivals/govardhan · /v1/vedic/festivals/bhaidooj · /v1/vedic/festivals/holi · /v1/vedic/festivals/shivaratri · /v1/vedic/festivals/janmashtami · /v1/vedic/festivals/rakshabandhan · /v1/vedic/festivals/upakarma · /v1/vedic/festivals/ramnavami · /v1/vedic/festivals/ganeshchaturthi · /v1/vedic/festivals/navaratri · /v1/vedic/festivals/chaitra-navaratri · /v1/vedic/festivals/ashadha-navaratri · /v1/vedic/festivals/magha-navaratri · /v1/vedic/festivals/makarsankranti — current Vikram samvat (or vikram / Gregorian year) + place; Dharmasindhu tithi-vyāpti (pradosha or niśītha), not sunrise tithi.

Kundali

/v1/vedic/kundali · planets · houses · lagna-kundali · ascendant · divisional · divisionals · dashas · dasha-phala · yogini-dashas · yogini-phala · dasha-timeline · varshaphal · gochara-report · janma-vivaran · yogas · karakas · jaimini · shadbala · ashtakavarga · ashtakavarga-phala · graha-garima · career-report · wealth-report · marriage-report · health-report · education-report · ratna-nirnaya · arishta · graha-shanti · children-report · varga-tulana · graha-saransh · bhava-saransh · bala-dashboard · avakahada · bhava-chalit · graha-drishti · maitri · maitri-chakra · chandra-kundali · surya-kundali · kundali/full · dosha/manglik · dosha/kaal-sarpa · dosha/manglik (Kuja, Phaladeepika 10, bhaṅga) · sade-sati (ḍhaiyā, gati, Phaladeepika 26) · ayurdaya (gaṇita + yoga-khaṇḍa + māraka, BPHS 43–44) · bhava-phala (BPHS 12–24 house / lord chain) · transits · kundali-book.html (Enterprise: full report HTML for WebView) · kundali-book.pdf (Enterprise: full report PDF) · kundali-pack (Enterprise: HTML + natal JSON for mobile)

Matching

/v1/vedic/match/ashtakoot (Muhūrta-cintāmaṇi, printed bhaṅga) · /v1/vedic/match/manglik

Ask Your Kundali

POST /v1/ask (8 credits) — question + saved native_id or native_key (mobile kundali id). Birth fields only if the chart is not saved yet. Engine runs the matching life-area report and answers from those facts. Optional interpreter: GPT-5.6 Luna by default, Terra for multi-factor questions (depth=auto|luna|terra). Matching-only keys cannot call Ask. Save: GET /v1/vedic/kundali-pack?save=1&native_key=… or POST /v1/natives. Voice (not a live call): POST /v1/ask/transcribe then the same Ask, then POST /v1/ask/speak for MP3. Live call (Talk to Astrologer): POST /v1/ask/call mints gpt-realtime-2.1 WebRTC secret; POST /v1/ask/call/{id}/end bills ₹100 / minute (5,000 credits / minute on metered plans). Friendly five-part consult: POST /v1/ask/mitra (10 credits) and POST /v1/ask/mitra/call — सरल भाषा; missing topics are read from the chart.

Core endpoints

GET /v1/panchanga

Free Basic: angas, vāra, sunrise/sunset, spaṣṭa grahas. Paid: full payload including display.

curl 'https://astro.tantragurukul.org/v1/panchanga?date=2026-08-22&place=कुशीनगर'

GET /v1/panchanga/daily

Compact mobile summary.

GET /v1/surya/panchanga

Sūrya-siddhānta engine. Default remains Drik. Free Basic may call this native route (and ?engine=surya on /v1/panchanga) for the same public slice as Drik Basic. Kundali, matching, and other paid surfaces on /v1/surya/… stay Commercial / Premium. Graha longitudes are Sūrya-siddhānta; house/dasha/yoga logic is the existing Drik code. See SSP-API License 1.0.

curl -H 'X-API-Key: your-commercial-key'   'https://astro.tantragurukul.org/v1/surya/tithi?date=2026-08-19&place=दिल्ली'

GET /v1/panchanga/range

Enterprise custom license only. One day per item, max 31 days. Requires start and end. Same for /v1/panchanga-kala and /v1/panchanga/month.

GET /v1/kundali

Birth chart: planets, houses, lagna, Vimśottarī daśā. Pass birth time.

GET /v1/vedic/lagna-kundali

Whole-sign D1 table: graha, rāśi, aṃśa, nakṣatra, bhāva, avasthā, gati. Same birth query as kundali.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/lagna-kundali?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/chandra-kundali

Same whole-sign D1 table as lagna kundali, with the natal Moon as Lagna. Sūrya mirror: /v1/surya/chandra-kundali.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/chandra-kundali?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/surya-kundali

Same whole-sign D1 table as lagna kundali, with the natal Sun as Lagna. Sūrya mirror: /v1/surya/surya-kundali.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/surya-kundali?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/graha-drishti

Parāśari graha dṛṣṭi on whole-sign bhāvas: graha, dṛṣṭi name, target rāśi, bhāva, occupants. Sūrya mirror: /v1/surya/graha-drishti.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/graha-drishti?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/graha-garima

Dignity flags: uccha, nīca, svakṣetra, mitra, śatru, mūlatrikona, combust, rāśi-sandhi, vargottama. Sūrya: /v1/surya/graha-garima.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/graha-garima?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/varga-tulana

D1–D60 rāśi for Lagna and nine grahas. Vargottama is D1 = D9. Sūrya: /v1/surya/varga-tulana.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/varga-tulana?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/graha-saransh

Per-graha cards: rāśi, bhāva, nakṣatra, navāṃśa, ṣaḍbala, BAV, avasthā, gati, houses ruled, dṛṣṭi, garima. Sūrya: /v1/surya/graha-saransh.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/graha-saransh?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/bhava-saransh

Twelve bhāva cards: rāśi, lord, occupants, dṛṣṭi, SAV, lord ṣaḍbala. Sūrya: /v1/surya/bhava-saransh.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/bhava-saransh?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/dashas

Vimśottarī mahādaśā, antardaśā, and pratyantardaśā from the natal Moon, plus Yogini mahā/antar in dashas.yogini. Full 120-year Vimśottarī timeline. Sūrya: /v1/surya/dashas.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/dashas?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/dasha-phala

Contextual BPHS mahā–antar phala for the next 10 years (horizon_years 1–20). Each pair is judged by dignity, bhāva ownership/occupancy/dṛṣṭi, functional lordship, and pañcadhā maitri — not 81 fixed paragraphs, and not an invented event. Phaladeepika is the dignity cross-check. Sūrya: /v1/surya/dasha-phala.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/dasha-phala?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/yogini-dashas

36-year Yogini udu daśā: (nakṣatra + 3) mod 8 from Ashwini, eight Yoginis Mangala–Sankata, antardaśā = mahā × sub / 36, three cycles (108 years). Sūrya: /v1/surya/yogini-dashas.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/yogini-dashas?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/yogini-phala

Contextual BPHS Yogini mahā–antar phala for the next 10 years (horizon_years 1–20). Each pair is the two Yoginis plus their lords’ dignity, bhāva, and pañcadhā maitri — not 64 fixed paragraphs. Jātaka-pārijāta is the second wheel source. Sūrya: /v1/surya/yogini-phala.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/yogini-phala?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/ayurdaya

Piṇḍāyu, Naisargikāyu, and Aṃśāyu (BPHS Āyurdāya), printed haraṇas, Phaladeepika selection, then vastavik yoga-khaṇḍa (three pairs, kakṣyā change) and māraka daśā inside that window — not a death-date. Sūrya: /v1/surya/ayurdaya.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/ayurdaya?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/bhava-phala

Twelve-house phala from BPHS: Lagna → bhāva → bhāveśa → dignity → dṛṣṭi/yuti → kāraka → daśā. Sārāvalī and Phaladeepika are cross-checks. No generic rāśi-phala line, and no Bhrigu web compilation. Sūrya: /v1/surya/bhava-phala.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/bhava-phala?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/career-report

Karma report: 10th / daśameśa, 6th service, 2nd+11th income, yogas, relative SAV, ṣaḍbala, maitri, and Vimśottarī windows. Service vs enterprise tendency — not a job title. Sūrya: /v1/surya/career-report.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/career-report?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/wealth-report

Dhana report: 2nd store, 11th gains, 9th fortune, 4th property, 8th/12th strain, yogas, SAV, ṣaḍbala, timing. Each section names the BPHS adhyāya (edition numbers vary). Capacity, not an amount. Sūrya: /v1/surya/wealth-report.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/wealth-report?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/marriage-report

Kalatra report: 7th / saptameśa, Venus and Jupiter, D9 confirmation, yogas, SAV, ṣaḍbala, maitri, timing. Kuja is a flag to Manglik. BPHS adhyāya cites. Possibility, not a wedding date. Sūrya: /v1/surya/marriage-report.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/marriage-report?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/health-report

Deha report: Tanu (1), Ari (6), Randhra (8), Sun/Moon/Mars/Saturn, yogas, SAV, ṣaḍbala, timing. Constitution and sensitive zones — not a diagnosis. Longevity math stays on Ayurdaya. BPHS adhyāya cites. Sūrya: /v1/surya/health-report.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/health-report?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/education-report

Vidyā report: Bandhu (4), Putra (5), Dharma (9), Mercury/Jupiter, yogas, SAV, ṣaḍbala, timing. Learning style and capacity — not an exam result or a named degree. BPHS adhyāya cites. Sūrya: /v1/surya/education-report.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/education-report?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/ratna-nirnaya

Ratna-nirṇaya: Phaladeepika 2.29 names the gem; BPHS 34 decides who is yogakāraka or a functional benefic. Exclusive 6/8/12 lords are not strengthened. BPHS Graha-śānti (ch. 84) is mantra–homa–dāna, not a shop list. Support for a weak benefic — not a fortune charm. Sūrya: /v1/surya/ratna-nirnaya.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/ratna-nirnaya?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/arishta

Arishta-khaṇḍa: BPHS 9 yogas, 10.1–4 bhaṅga, 9.2 twenty-four-year window, 44.2/44.5 māraka daśā as a sensitive kāla, and 84 śānti. D1, Chandra-kundali, D9, D30, D60. Not a death date. Sūrya: /v1/surya/arishta.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/arishta?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/graha-shanti

Graha-śānti: BPHS 34 decides who is a functional pāpa; BPHS 84 is mantra–homa–dāna. Phaladeepika 2.27–30 maps deity, grain, metal, cloth. Sārāvalī checks graha-nature. Mānasāgarī weekday dāna is later paddhati. Do not pacify a yogakāraka. Not a diagnosis. Sūrya: /v1/surya/graha-shanti.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/graha-shanti?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/children-report

Santāna report: Putra (5), Kutumba (2), Bandhu (4), Jupiter/Moon, yogas, SAV, ṣaḍbala, timing. Capacity and home tone — not a child-count, gender, or birth date. BPHS adhyāya cites. Sūrya: /v1/surya/children-report.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/children-report?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/dasha-timeline

Wrap of dasha-phala and yogini-phala: current mahā–antar, next 1 / 3 / 5 years, and change windows. No new daśā math. Support, not an event. BPHS adhyāya cites. Sūrya: /v1/surya/dasha-timeline.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/dasha-timeline?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/varshaphal

Tajika Nīlakaṇṭhī varṣaphala: sidereal Lahiri Sun-return (Drik), muntha, pañca-adhikārī / varṣeśa, three mudda daśās, Ithasāla, and five attested sahams. Year capacity — not a job, wedding, or death date. Drik: Lahiri return. Sūrya: sphuṭa Sūrya return from Sūrya-siddhānta. Sūrya: /v1/surya/varshaphal.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/varshaphal?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/samvatsara

Annual Saṃhitā / Medinī year — not natal Tājika varṣaphala. Public rājā is the Caitra śukla pratipadā weekday (living pañcāṅga). If that pratipadā is kṣaya, rājā is the weekday-lord of the vara on which pratipadā begins. Caitra amāvasyā weekday is kept as Grahavarṣapati — an older / alternate school, not rājā (Kern/Bhat apparatus; not a quoted Varāhamihira mūla-śloka). Mantrī is the Meṣa-saṅkrānti weekday (mantri-maṇḍala). Ingress charts at both moments; house reading is a BPHS-kāraka method. Phenomena: eclipses (ch. 5), close meetings (ch. 17), Rohiṇī / Svāti / Āṣāḍha dates (ch. 21–28) that still need observation. Extra navanāyaka offices are omitted until a printed paddhati is locked. Slow-graha carita (Guru, Śani, Rāhu signs) is dated, not given invented phala. Default place is New Delhi unless place or coordinates are sent. Admin, Enterprise, and the first-party mobile API only — not on Examples. Sūrya: /v1/surya/samvatsara.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/samvatsara?year=2026&place=दिल्ली'

GET /v1/vedic/gochara-report

Current slow-graha gochara from natal Lagna and Moon, natal impact (Phaladeepika 26), upcoming sign-ingresses, and each graha’s own Bhinna bindus plus relative SAV. Not a 30+ cutoff, and not an event. Drik: Lahiri snapshot and ingresses. Sūrya: sphuṭa graha. Sūrya: /v1/surya/gochara-report.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/gochara-report?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/kundali-book.html

Standalone HTML of the natal book for a WebView. Enterprise only. White-label same as the PDF. Print on device: HTML → PDF. Sūrya: /v1/surya/kundali-book.html.

curl -H 'X-API-Key: YOUR-APP-KEY'   'https://astro.tantragurukul.org/v1/vedic/kundali-book.html?date=1990-05-15&time=14:30&place=दिल्ली&name=राम'

GET /v1/vedic/kundali-book.pdf

One printable PDF of the full natal book. Enterprise only (from ₹21,000 / year, unlimited credits). Pass white_label=1 with brand_name and optional brand_logo (https URL) — no watermark. Optional girl_date adds the matching chapter. Sūrya: /v1/surya/kundali-book.pdf.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/kundali-book.pdf?date=1990-05-15&time=14:30&place=दिल्ली&name=राम'

GET /v1/vedic/kundali-pack

Mobile bundle: HTML, natal JSON (planets, dashas, aṅgas), and calls. Enterprise only. No PDF unless include_pdf=1. Print: HTML → PDF. Sūrya: /v1/surya/kundali-pack.

curl -H 'X-API-Key: YOUR-APP-KEY'   'https://astro.tantragurukul.org/v1/vedic/kundali-pack?date=1990-05-15&time=14:30&place=दिल्ली&name=राम&white_label=1&brand_name=तंत्रकुलज्योतिषम्'

Full wiring: Mobile kundali pack.

GET /v1/vedic/bala-dashboard

Strength cards plus CSS bar charts and SAV heatmap (no Chart.js). Sūrya: /v1/surya/bala-dashboard.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/bala-dashboard?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/ashtakavarga

Parāśari pack: bhinnāṣṭaka, sarvāṣṭaka, prastāra, trikoṇa/ekādhipatya śodhana, śodhya piṇḍa, and SAV on D9 D10 D7 D12 D4. Sūrya mirror: /v1/surya/ashtakavarga.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/ashtakavarga?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/ashtakavarga-phala

BPHS predictive layer on those bindus: natal promise → daśā → relative Sarvāṣṭakavarga house ranks → the transiting graha’s own BAV. Not a “30+ is good” cutoff. Sūrya: /v1/surya/ashtakavarga-phala.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/ashtakavarga-phala?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/jaimini

Jaimini pack: chara karakas, karakamsha, arudha A1–A12, upapada, rāśi dṛṣṭi. Karakas only: /v1/vedic/karakas. Sūrya mirrors under /v1/surya/….

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/jaimini?date=1990-05-15&time=14:30&place=दिल्ली'

GET /v1/vedic/divisional

One Parāśari varga (default chart=D9): whole-sign table from the varga Lagna — rāśi, aṃśa, nakṣatra, bhāva. Codes: D1 D2 D3 D4 D7 D9 D10 D12 D16 D20 D24 D27 D30 D40 D45 D60. All sixteen: /v1/vedic/divisionals. Sūrya mirrors: /v1/surya/divisional and /v1/surya/divisionals.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/divisional?date=1990-05-15&time=14:30&place=दिल्ली&chart=D9'

GET /v1/vedic/bhava-chalit

Sripati bhāva-sandhi (chalit): 12 houses with start, mid, end, a printer bhavas table (start rāśi, aṃśa, bhāva-madhya, occupants with strength %), plus each graha’s house and Phaladīpikā strength (1 at bhāva-madhya, 0 at sandhi). Drik daśama is the Placidus Midheaven. Commercial /v1/surya/bhava-chalit and ?engine=surya use Sūrya-siddhānta RAMC and 24° obliquity. /v1/surya/houses cusps stay rāśi-bhāva (sign starts); ascmc.mc is that same daśama, not a sign-start stand-in.

curl -H 'X-API-Key: your-key'   'https://astro.tantragurukul.org/v1/vedic/bhava-chalit?date=1990-05-15&time=14:30&place=दिल्ली'
curl -H 'X-API-Key: your-commercial-key'   'https://astro.tantragurukul.org/v1/surya/bhava-chalit?date=1990-05-15&time=14:30&place=दिल्ली'

GET /drik_panchang

Human HTML page. Legacy /panchanga redirects here.

Response

{
  "success": true,
  "panchanga": {
    "ayanamsa": "Lahiri",
    "date": { "year": 2026, "month": 8, "day": 22 },
    "tithi": {}, "yoga": {}, "karana": {}, "nakshatra": {},
    "display": { "tithi": "दशमी" }
  }
}

Errors

Validation returns HTTP 422. Domain errors return {"success": false, "error": "..."} with 400 or 500.