# 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.