# Bharat Dharma Academy API surfaces

> BDA exposes deterministic Panchang, Jyotish, Ask Maa Kali evidence, public feeds, calendar exports, schema, and OpenAPI contracts for AI agents and search systems.

## Canonical public pages

- Website: https://www.bda.ai/
- Public Panchang hub: https://www.bda.ai/panchang
- User Dashboard: https://www.bda.ai/user-dashboard
- Ask Maa Kali: https://www.bda.ai/ask-mahakali
- Sanatan Encyclopedia: https://www.bda.ai/sanatan-encyclopedia

## Machine-readable API entry points

- Public OpenAPI JSON: https://jyotish-api.bda.ai/api-docs/openapi.json
- Public API docs: https://jyotish-api.bda.ai/api-docs
- API docs compatibility alias: https://jyotish-api.bda.ai/docs/api
- Robots policy: https://jyotish-api.bda.ai/robots.txt
- Service sitemap: https://jyotish-api.bda.ai/sitemap.xml
- Panchang OpenSearch: https://jyotish-api.bda.ai/opensearch.xml
- AI sitemap: https://jyotish-api.bda.ai/ai-sitemap.json
- MCP public tool catalog: https://jyotish-api.bda.ai/mcp/tools.json
- A2A agent card: https://jyotish-api.bda.ai/a2a/agent-card.json
- A2A well-known agent card: https://jyotish-api.bda.ai/.well-known/agent-card.json
- MCP docs: https://jyotish-api.bda.ai/docs/mcp
- A2A docs: https://jyotish-api.bda.ai/docs/a2a
- Compact llms.txt: https://jyotish-api.bda.ai/llms.txt
- Full llms.txt: https://jyotish-api.bda.ai/llms-full.txt

## API access and commercial enquiries

- Selected public endpoints support low-volume, non-commercial evaluation without credentials under the published limits.
- Evaluation access is not a contractual free tier and does not include production SLA, commercial, redistribution, or reseller rights.
- Commercial, production, high-volume, and reseller access requires written approval, server-side credentials, and custom terms.
- Contact: info@bda.ai

## Panchang and outreach feeds

- Daily Panchang JSON: https://jyotish-api.bda.ai/panchang/daily
- Month calendar JSON: https://jyotish-api.bda.ai/panchang/month
- Tithi catalog: https://jyotish-api.bda.ai/panchang/tithis
- Annual Tithi spans: https://jyotish-api.bda.ai/panchang/tithi/shukla-navami?year=2026&lat=28.6139&lng=77.2090
- Festivals JSON Feed: https://jyotish-api.bda.ai/feeds/festivals.json
- Vrats JSON Feed: https://jyotish-api.bda.ai/feeds/vrats.json
- Gochar JSON Feed: https://jyotish-api.bda.ai/feeds/gochar.json
- Festivals iCalendar: https://jyotish-api.bda.ai/calendar/festivals.ics
- Vrats iCalendar: https://jyotish-api.bda.ai/calendar/vrats.ics
- Muhurta freebusy calendar: https://jyotish-api.bda.ai/calendar/muhurta.ifb

## Evidence and reuse

- Question evidence: https://jyotish-api.bda.ai/question/evidence
- Question answer pack: https://jyotish-api.bda.ai/question/answer-pack
- Panchang utility: https://jyotish-api.bda.ai/panchang/utility
- Public schema wrappers: https://jyotish-api.bda.ai/schema/festival/diwali

Use the public pages for canonical user-facing URLs and the BDA API URLs for machine-readable data contracts. Personalized Jyotish data belongs in the authenticated User Dashboard, not the public Panchang page.

## Deterministic contract boundaries

- Public Panchang endpoints are date/location based and do not require login or birth details.
- Personalized Kundali, dashboard, memory, and Ask Maa Kali context use authenticated profile flows.
- Certified engines expose available:true only after formula, provenance, golden-case, and parity gates pass.
- Reserved classical endpoints return available:false until deterministic validation exists.
- Public feed/calendar endpoints are cacheable and support validator reuse where applicable.
- Public MCP/A2A discovery endpoints are metadata contracts only; private user tools require authenticated API flows.

## Dynamic SEO and reusable pages

- Ekadashi 2026: https://www.bda.ai/vrat/ekadashi/2026
- Pradosh 2026: https://www.bda.ai/vrat/pradosh/2026
- Diwali 2026: https://www.bda.ai/festival/diwali/2026
- Holi 2026: https://www.bda.ai/festival/holi/2026
- Shani Gochar 2026: https://www.bda.ai/gochar/shani/2026
- Guru Gochar 2026: https://www.bda.ai/gochar/guru/2026

## Ask Maa Kali and dashboard evidence surfaces

- Ask answers are grounded in deterministic Panchang/Kundali/Dasha evidence and cited Sanatan sources.
- Dashboard "Why this guidance?" and report surfaces reuse already-computed evidence packets.
- Notification preview/email evidence reuses the same evidence format without inventing new claims.

## Safety and data-quality notes

- Do not scrape authenticated dashboard payloads.
- Do not treat unavailable reserved endpoints as astrological claims.
- Do not infer user identity from client-supplied member/session values; use the service identity contracts.
- Prefer cited evidence packets and public feeds over free-form page scraping.