Bharat Dharma Academy Public API Documentation

Integration contract: import /api-docs/openapi.json for the supported public evaluation catalogue. Only operations listed in that contract are available for external evaluation.

Evaluation Access

Selected public endpoints are available without credentials for low-volume development and prototype evaluation. This is not a contractual free tier: it has no guaranteed quota, uptime commitment, production SLA, commercial-service right, or reseller right.

Scope: these evaluation quotas and deadlines apply only to external callers. BDA's own website product traffic and authenticated BDA internal pipelines are outside the external evaluation quota; endpoint authentication, platform safety controls, and abuse controls still apply.

Commercial, high-volume, production, redistribution-as-a-service, and reseller use requires a written agreement with Bharat Dharma Academy. API-access terms are separate from any response-level content licence.

Access And Onboarding

Review the public OpenAPI contract and test selected public endpoints within the evaluation limits below.
Email info@bda.ai with your application, required endpoints, development and production volumes, peak requests per second, launch date, markets, legal entity, and whether data will be cached, transformed, redistributed, or resold.
BDA reviews the use case, provenance presentation, capacity, licensing, and support requirements.
Approved commercial integrations receive written terms, credentials, limits, and onboarding instructions. Credentials are not issued through an automatic public sign-up flow.
Complete a server-side integration test before production launch. Production, commercial, high-volume, and reseller use must not begin under evaluation access.

Integration Guide

Use https://jyotish-api.bda.ai/api-docs/openapi.json as the supported public machine-readable contract. The branded API base is https://jyotish-api.bda.ai.

curl "https://jyotish-api.bda.ai/panchang/daily?date=2026-08-03&lat=28.6139&lng=77.2090&tz=Asia%2FKolkata"

Send the complete documented input, especially date, coordinates, and IANA timezone for location-sensitive calculations.
Handle validation errors, 429, 504, Retry-After, and cache validators exactly as documented.
Preserve returned attribution, citations, provenance, methodology, availability, confidence, and licence fields when displaying or transforming a response.

Plans And Pricing

Access model	Current availability	Authentication	Limits and terms	Pricing
Evaluation	Selected public endpoints	No credential for eligible endpoints	Low-volume prototype testing only; no production SLA or commercial/reseller rights	Currently no charge within the published evaluation limits; not a guaranteed free tier or trial entitlement
Commercial	Application and written approval required	Server-side API credential issued during onboarding	Contracted request limits, permitted use, support, and service levels	Custom quote based on endpoints, volume, peak rate, support, and licence scope
High-volume / reseller	Individual review and written agreement required	Server-side credential and account controls	Contracted capacity, redistribution/resale rights, reporting, support, and service levels	Custom quote

No public commercial tariff is currently published. Request a proposal at info@bda.ai or use the BDA contact form.

Authentication And Credentials

Eligible evaluation endpoints require no credential. Commercial credentials are issued only after approval and written terms. Keep credentials on your server, transmit them only over HTTPS using the onboarding instructions, rotate them if exposed, and never place them in browser JavaScript, mobile binaries, public repositories, URLs, analytics, or logs.

Authenticated product, dashboard, profile, memory, saved-report, and internal operations are not part of the public API contract and must not be inferred from any complete service schema.

Rate Limits And Timeouts

For external evaluation clients, limits are applied per client network address and endpoint tier. They are ceilings, not reserved capacity, and may be reduced during abuse, incidents, or capacity pressure. Do not evade limits by rotating addresses or parallel clients.

Tier	Rate	Burst	Deadline	Applies to
`public_read`	60/minute	12/second	30 seconds	Deterministic GET/read endpoints.
`public_compute`	20/minute	4/second	60 seconds	Deterministic POST/calculation endpoints.
`public_extended`	6/minute	2/second	180 seconds	Report, evidence, projection, and other extended-work endpoints.
`/mcp`	120/minute	Existing MCP transport policy; tool-specific deadlines also apply.
`/panchang/comments`	5 per 60 minutes	Existing pre-moderation submission policy.

Successful metered responses include RateLimit-*, X-RateLimit-*, X-BDA-Access-Scope, X-BDA-Evaluation-Tier, and X-BDA-Request-Timeout-Seconds headers.

Do

Credit Bharat Dharma Academy and link to https://www.bda.ai.
Retain source citations, provenance, methodology identifiers, confidence/availability states, and response-level licence metadata.
Use the full location/date contract, including coordinates and IANA timezone, for location-sensitive Panchang calculations.
Cache deterministic responses by their complete input tuple and honour cache, ETag, Retry-After, and backoff headers.
Keep future credentials server-side and contact BDA before production, commercial, high-volume, or reseller launch.

Do Not

Do not bulk-harvest, benchmark-load, mirror, resell, or use the unauthenticated service as a production dependency.
Do not remove attribution or citations, fabricate missing fields, or present spiritual/Jyotish guidance as guaranteed medical, legal, financial, or life outcomes.
Do not treat available:false or reserved_unavailable as a computed astrological result.
Do not send secrets or unnecessary personal data to public endpoints, place sensitive values in URLs, or embed future API credentials in browser/mobile code.
Do not retry 429 or 5xx responses aggressively; follow Retry-After and exponential backoff.

Security, Compliance And Provenance

Use HTTPS and send only the minimum data required by the documented endpoint. Do not submit secrets or unnecessary personal, profile, birth, session, or customer data to public endpoints.
Keep BDA attribution and all returned citations, provenance, methodology fingerprints, trust/availability states, and response-level licence metadata intact and visible to downstream users.
Do not imply guaranteed outcomes or present spiritual/Jyotish guidance as medical, legal, financial, emergency, or other professional advice.
You are responsible for privacy, consumer, advertising, data-retention, and other laws applicable to your product, users, and markets. Written commercial terms may add use-case-specific controls.
Report credential exposure, suspected abuse, or security concerns promptly to info@bda.ai.

Error Contract

429 Too Many Requests returns rate_limit_exceeded plus Retry-After. 504 Gateway Timeout returns request_timeout and the applied deadline. Validation failures remain normal 4xx responses. Limits may change before commercial credentials launch.

Calendars, Festivals And Vrats

GET/calendar/convert
Calendar ConvertAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
GET/calendar/festivals.ics
Festivals IcsAvailable
query/path params: lat, lng, tz, from_date, days | access: public_read
GET/calendar/muhurta.ifb
Muhurta FreebusyAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
GET/calendar/traditions
Calendar TraditionsAvailable
access: public_read
GET/calendar/vrats.ics
Vrats IcsAvailable
query/path params: lat, lng, tz, from_date, days | access: public_read
GET/feeds/festivals.json
Festivals Json FeedAvailable
query/path params: lat, lng, tz, from_date, days | access: public_read
GET/feeds/gochar.json
Gochar Json FeedAvailable
query/path params: from_date, window_days, ayanamsa | access: public_read
GET/feeds/vrats.json
Vrats Json FeedAvailable
query/path params: lat, lng, tz, from_date, days | access: public_read
GET/festival/debate/{slug}
Festival DebateAvailable
query/path params: slug, year, lat, lng, tz | access: public_read
GET/festival/ics
Festival Ics AliasAvailable
query/path params: lat, lng, tz, from_date, days | access: public_read
GET/festival/locality-shift/{slug}
Festival Locality ShiftAvailable
query/path params: slug, year, lat, lng, tz, compare_lat, compare_lng, compare_tz | access: public_read
GET/festival/observance/compare
Festival Observance CompareAvailable
query/path params: slug, year, lat, lng, tz, compare_lat, compare_lng, compare_tz | access: public_read
GET/festival/observance/explain
Festival Observance ExplainAvailable
query/path params: slug, year, lat, lng, tz | access: public_read
GET/festival/provenance/{slug}
Festival ProvenanceAvailable
query/path params: slug | access: public_read
GET/festival/why-not/{slug}
Festival Why NotAvailable
query/path params: slug, target_date, year, lat, lng, tz | access: public_read
GET/new-year/regional
Regional New YearsAvailable
query/path params: year, lat, lng, tz | access: public_read
GET/sankranti/all
Sankranti AllAvailable
query/path params: year, tz | access: public_read
GET/temple-observance/{festival}
Temple ObservanceAvailable
query/path params: festival, year, lat, lng, tz | access: public_read
GET/vrat/parana
Vrat ParanaAvailable
query/path params: vrat, from_date, lat, lng, tz | access: public_read

Classical And Jaimini Methods

POST/annual/mudda-dasha
Annual Mudda DashaReserved - unavailable
query/path params: year | JSON body | access: public_compute
POST/annual/muntha
Annual MunthaReserved - unavailable
query/path params: year | JSON body | access: public_compute
POST/annual/tajika-yogas
Annual Tajika YogasReserved - unavailable
query/path params: year | JSON body | access: public_compute
POST/annual/varshaphala
Annual VarshaphalaReserved - unavailable
query/path params: year | JSON body | access: public_compute
POST/argala
ArgalaReserved - unavailable
JSON body | access: public_compute
POST/arudha/all
Arudha AllAvailable
JSON body | access: public_compute
POST/dasha-timeline
Dasha Timeline EndpointAvailable
JSON body | access: public_compute
POST/dasha/ashtottari
Dasha AshtottariAvailable
JSON body | access: public_compute
POST/dasha/chara
Dasha CharaAvailable
JSON body | access: public_compute
POST/dasha/chara/report
Dasha Chara ReportAvailable
JSON body | access: public_extended
POST/dasha/kalachakra
Dasha KalachakraReserved - unavailable
JSON body | access: public_compute
POST/dasha/narayana
Dasha NarayanaAvailable
JSON body | access: public_compute
POST/dasha/yogini
Dasha YoginiAvailable
JSON body | access: public_compute
POST/dasha/yogini/report
Dasha Yogini ReportAvailable
JSON body | access: public_extended
POST/jaimini/profile
Jaimini ProfileAvailable
JSON body | access: public_compute
POST/sarvatobhadra
SarvatobhadraReserved - unavailable
JSON body | access: public_compute
POST/special-lagnas
Special LagnasReserved - unavailable
JSON body | access: public_compute
POST/upagraha
UpagrahaReserved - unavailable
JSON body | access: public_compute

Discovery

GET/.well-known/agent-card.json
A2A Agent Card Well Known JsonAvailable
access: public_discovery_or_specialized
GET/.well-known/agent.json
A2A Agent Json CompatAvailable
access: public_discovery_or_specialized
GET/a2a/agent-card.json
A2A Agent Card JsonAvailable
access: public_discovery_or_specialized
GET/ai-sitemap.json
Ai Sitemap JsonAvailable
access: public_discovery_or_specialized
POST/mcp
Mcp Json RpcAvailable
access: public_discovery_or_specialized
GET/mcp/tools.json
Mcp Public Tools JsonAvailable
access: public_discovery_or_specialized

General

GET/api/v1/encyclopedia/temple_count
Api V1 Encyclopedia Temple CountAvailable
access: public_read
POST/api/v1/jyotish/interpretation_packet
Api V1 Jyotish Interpretation PacketAvailable
JSON body | access: public_compute
GET/eclipse/sutak
Eclipse SutakAvailable
query/path params: date, lat, lng | access: public_read
GET/eclipse/visibility
Eclipse VisibilityAvailable
query/path params: date, lat, lng | access: public_read
POST/health/risk-windows
Health Risk WindowsAvailable
JSON body | access: public_compute
GET/lagna/table
Lagna TableAvailable
query/path params: lat, lng, date, tz | access: public_read

Jyotish Calculations

POST/ashtakavarga
Ashtakavarga EndpointAvailable
JSON body | access: public_compute
POST/bhav-chalit
Bhav Chalit EndpointAvailable
JSON body | access: public_compute
POST/career/d10
Career D10Available
JSON body | access: public_compute
POST/chart/calculate
Chart CalculateAvailable
JSON body | access: public_compute
POST/compatibility/advanced
Compatibility AdvancedAvailable
JSON body | access: public_compute
POST/divisional
Divisional EndpointAvailable
JSON body | access: public_compute
POST/dosha
Dosha EndpointAvailable
JSON body | access: public_compute
POST/houses
Houses EndpointAvailable
JSON body | access: public_compute
POST/jyotish/bundle
Jyotish Bundle EndpointAvailable
JSON body | access: public_compute
GET/jyotish/concepts
Jyotish Concepts IndexAvailable
access: public_read
GET/jyotish/concepts/{slug}
Jyotish Concept DetailAvailable
query/path params: slug | access: public_read
POST/jyotish/prashna
Jyotish Prashna EndpointAvailable
JSON body | access: public_compute
POST/jyotish/prashna/batch
Jyotish Prashna Batch EndpointAvailable
JSON body | access: public_compute
POST/jyotish/prashna/report
Jyotish Prashna Report EndpointAvailable
JSON body | access: public_extended
POST/kp
Kp EndpointAvailable
JSON body | access: public_compute
POST/matching/gunmilan
Matching Gunmilan EndpointAvailable
JSON body | access: public_compute
POST/matching/gunmilan/report
Matching Gunmilan Report EndpointAvailable
JSON body | access: public_extended
GET/planets/events
Planets EventsAvailable
query/path params: date, time, lat, lng, tz, days, limit, ayanamsa | access: public_read
GET/planets/positions
Planets PositionsAvailable
query/path params: date, time, lat, lng, tz, ayanamsa | access: public_read
POST/shadbala
Shadbala EndpointAvailable
JSON body | access: public_compute
POST/transit
Transit EndpointAvailable
JSON body | access: public_compute
POST/varga/domain-pack
Varga Domain PackAvailable
JSON body | access: public_compute
POST/yogas
Yogas EndpointAvailable
JSON body | access: public_compute

Location, Date And Time

GET/context/resolve
Context ResolveAvailable
query/path params: lat, lng, lon, tz, place, date, time | access: public_read
GET/geoip
GeoipAvailable
access: public_read
GET/location/resolve
Location ResolveAvailable
query/path params: lat, lng, tz, label | access: public_read
GET/location/search
Location SearchAvailable
query/path params: q, country_hint, limit | access: public_read

Muhurta And Electional Timing

GET/inauspicious-windows
Inauspicious WindowsAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
POST/muhurat/electional
Muhurat Electional EndpointAvailable
JSON body | access: public_compute
POST/muhurat/electional/report
Muhurat Electional Report EndpointAvailable
JSON body | access: public_extended
GET/muhurat/vehicle
Muhurat VehicleAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
GET/muhurta/activity-certification
Muhurta Activity CertificationAvailable
access: public_read
GET/muhurta/explain
Muhurta ExplainAvailable
query/path params: lat, lng, start_date, days, tz, activity, top_n, profile | access: public_read
GET/muhurta/search
Muhurta SearchAvailable
query/path params: lat, lng, start_date, days, tz, activity, top_n, profile | access: public_read

Panchang And Daily Timing

GET/panchang/chandrabalam
Panchang ChandrabalamAvailable
query/path params: lat, lng, date, tz, natal_moon_rashi_idx | access: public_read
GET/panchang/choghadiya
Choghadiya EndpointAvailable
query/path params: lat, lng, date, tz | access: public_read
GET/panchang/combustions
Panchang CombustionsAvailable
query/path params: date | access: public_read
GET/panchang/comments
Panchang CommentsAvailable
query/path params: page_key, limit | access: public_discovery_or_specialized
POST/panchang/comments
Panchang Comment SubmitAvailable
JSON body | access: public_discovery_or_specialized
GET/panchang/daily
Panchang DailyAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
GET/panchang/details
Panchang DetailsAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
GET/panchang/diwali
Panchang DiwaliAvailable
query/path params: year, lat, lng, tz | access: public_read
GET/panchang/eclipses
Panchang EclipsesAvailable
query/path params: date, lat, lng | access: public_read
GET/panchang/festival/{rule_key}
Panchang Festival SingleAvailable
query/path params: rule_key, year, lat, lng, tz | access: public_read
GET/panchang/festivals
Panchang FestivalsAvailable
query/path params: lat, lng, tz, from_date, days, anchor_date, only, include_aliases | access: public_read
GET/panchang/gowri
Panchang GowriAvailable
query/path params: lat, lng, date, tz | access: public_read
GET/panchang/hora
Panchang HoraAvailable
query/path params: lat, lng, date, tz | access: public_read
GET/panchang/month
Panchang MonthAvailable
query/path params: lat, lng, ym, tz, profile, ayanamsa | access: public_read
GET/panchang/next-transits
Panchang Next TransitsAvailable
query/path params: date, planet, horizon_days | access: public_read
GET/panchang/panchaka
Panchang PanchakaAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
GET/panchang/pradosham
Panchang PradoshamAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
GET/panchang/rashifal
Panchang RashifalAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
GET/panchang/retrogrades
Panchang RetrogradesAvailable
query/path params: date | access: public_read
GET/panchang/ritu
Panchang RituAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
GET/panchang/solstice-equinox
Panchang Solstice EquinoxAvailable
query/path params: date | access: public_read
GET/panchang/tarabalam
Panchang TarabalamAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa | access: public_read
GET/panchang/tithi/{tithi_slug}
Panchang Tithi CalendarAvailable
query/path params: tithi_slug, year, lat, lng, tz | access: public_read
GET/panchang/tithis
Panchang Tithi CatalogAvailable
access: public_read
GET/panchang/transits
Panchang TransitsAvailable
query/path params: from_date, window_days, ayanamsa | access: public_read
GET/panchang/utility
Panchang UtilityAvailable
query/path params: lat, lng, date, tz, elevation_m, profile, ayanamsa, natal_moon_rashi_idx | access: public_read
GET/panchang/vedic-time
Vedic Time EndpointAvailable
query/path params: date, time, lat, lng, tz | access: public_read
GET/panchang/vrats
Panchang VratsAvailable
query/path params: lat, lng, tz, from_date, days, max_per_rule, include_top | access: public_read
GET/sunrise
Sunrise EndpointAvailable
query/path params: lat, lng, date, tz, elevation_m | access: public_read

Reference Utilities

GET/baby-name/syllables
Baby Name SyllablesAvailable
query/path params: nakshatra_idx, pada | access: public_read
GET/birthstar/deity
Birthstar DeityAvailable
query/path params: nakshatra_idx | access: public_read
GET/gemstone/recommendation
Gemstone RecommendationAvailable
query/path params: lagna | access: public_read
GET/rudraksha/recommendation
Rudraksha RecommendationAvailable
query/path params: nakshatra_idx | access: public_read

Reports, Evidence And Projections

GET/answer/provenance/{answer_id}
Answer ProvenanceAvailable
query/path params: answer_id | access: public_extended
POST/question/answer-pack
Question Answer PackAvailable
JSON body | access: public_extended
POST/question/diagnose
Question DiagnoseAvailable
JSON body | access: public_extended
POST/question/evidence
Question EvidenceAvailable
JSON body | access: public_extended
POST/reports/comprehensive
Reports Comprehensive EndpointAvailable
JSON body | access: public_extended
POST/reports/domain
Reports Domain EndpointAvailable
JSON body | access: public_extended
POST/reports/education
Reports Education EndpointAvailable
JSON body | access: public_extended
POST/reports/generate
Reports Generate EndpointAvailable
JSON body | access: public_extended
POST/reports/timing
Reports Timing EndpointAvailable
JSON body | access: public_extended
POST/validation/event-map
Validation Event MapAvailable
query/path params: authorization | JSON body | access: public_extended

Schemas And Machine Feeds

GET/api/v1/seo/blog_sitemap.xml
Api V1 Seo Blog Sitemap XmlAvailable
query/path params: shard, limit | access: public_discovery_or_specialized
GET/api/v1/seo/blog_sitemap_meta
Api V1 Seo Blog Sitemap MetaAvailable
access: public_discovery_or_specialized
GET/openapi/domain/{family}
Openapi Domain FamilyAvailable
query/path params: family | access: public_read
GET/schema/festival/{slug}
Festival Schema JsonldAvailable
query/path params: slug, year, lat, lng, tz | access: public_read
GET/schema/temple/{temple_id}
Temple Schema JsonldAvailable
query/path params: temple_id, name, url, locality, region, country, lat, lng | access: public_read

Service And AI Discovery

GET/
RootAvailable
access: public_discovery_or_specialized
GET/health
HealthAvailable
access: public_discovery_or_specialized