canonical: https://jentic.com/apis/bhagavadgita.io/bhagavadgita # Bhagavad Gita API The Bhagavad Gita API exposes the complete text of the Bhagavad Gita organised by its 18 chapters and 700 verses, with each verse available in Sanskrit, transliteration, and translations or commentaries by recognised scholars. Agents can list all chapters, fetch a specific chapter's metadata, retrieve every verse in a chapter, or pull a single verse by chapter and verse number. Authentication uses an OAuth 2.0 client-credentials flow against the `/auth/oauth/token` endpoint to obtain a bearer token. The API is well suited to building reading apps, daily-verse delivery services, and AI study assistants. ## For AI agents Read chapters and verses of the Bhagavad Gita in Sanskrit, transliteration, and multiple translations for study apps and verse delivery. ## Scope Does not handle audio recitation, user accounts, or commentary submission - use for chapter and verse text retrieval only. ## Capabilities - Retrieve all 18 chapters of the Bhagavad Gita with chapter-level metadata - Fetch a specific chapter by its number with summary and verse count - List every verse within a chapter for a complete chapter reading - Pull a single verse by chapter and verse number for daily-verse delivery - Browse the complete corpus of all verses across the text - Exchange client credentials for an access token to authorise verse requests ## Use cases ### Daily Verse Delivery Service Send a verse from the Bhagavad Gita to subscribers each morning via email or push notification. The agent picks a chapter and verse number, calls `/api/v1/chapters/{chapter_number}/verses/{verse_number}`, and pipes the Sanskrit text and English translation into the message. The complete corpus is 700 verses, so a daily cycle covers roughly two years of unique content. Example prompt: Fetch `/api/v1/chapters/2/verses/47` and send the Sanskrit and English translation to the subscribed email list. ### Bhagavad Gita Study App Power a mobile or web study application that lets users read the Gita chapter by chapter, with verse-level navigation. The `/api/v1/chapters` endpoint returns the index, `/api/v1/chapters/{chapter_number}` returns chapter metadata, and `/api/v1/chapters/{chapter_number}/verses` returns the full chapter text. Translations and commentaries embedded in the verse object support comparative reading. Example prompt: Render chapter 4 by calling `/api/v1/chapters/4` for the summary and `/api/v1/chapters/4/verses` for the 42 verses. ### AI Spiritual Study Assistant Build a conversational AI that answers questions about the Bhagavad Gita with citations to the original verses. Through Jentic, the agent issues natural-language searches like 'find verse on duty' or 'get chapter 2 verses', loads the schema, and pulls the cited verse with chapter and verse number for the response. The OAuth token stays in your Jentic One instance so the agent never handles raw credentials. Example prompt: Search Jentic for 'fetch a Bhagavad Gita verse', execute `/api/v1/chapters/2/verses/47`, and quote it back with citation. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/api/v1/chapters` | List all 18 chapters | | GET | `/api/v1/chapters/{chapter_number}` | Get a specific chapter | | GET | `/api/v1/chapters/{chapter_number}/verses` | List all verses in a chapter | | GET | `/api/v1/chapters/{chapter_number}/verses/{verse_number}` | Get a specific verse | | GET | `/api/v1/verses` | List every verse | | POST | `/auth/oauth/token` | Exchange client credentials for an access token | ## Key resources - **Chapters** — List and retrieve the 18 chapters of the Bhagavad Gita - **Verses** — Retrieve verses by chapter or fetch every verse across the text - **OAuth token** — Exchange client credentials for an access token ## Why Jentic - **Setup:** Wiring the Bhagavad Gita API by hand means exchanging OAuth client credentials at `/auth/oauth/token`, refreshing the access token, and building chapter and verse paths yourself. Through Jentic you install once, import the Bhagavad Gita API from the API Directory, store the client credentials once, and your agent calls it. - **Permission scoping:** The Bhagavad Gita API puts the chapter number in the URL path (`/chapters/{chapter_number}/verses/...`), so a rule can pin your agent to one chapter and its verses. Every operation here is read-only text retrieval, so no write path is reachable regardless of the set you allow. - **Credential handling:** Your Bhagavad Gita OAuth client credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'fetch a Gita verse' or 'list the verses in a chapter', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Quran.com API** — Quran.com offers a parallel chapter-and-verse API for the Quran in multiple translations. - **Bible API** — Bible API offers free verse lookup across multiple Christian Bible translations. - **Al Quran Cloud API** — Al Quran Cloud is another Quran lookup API with audio recitation included. ## FAQ ### What authentication does the Bhagavad Gita API use? The API uses OAuth 2.0 client credentials. POST your client_id and client_secret to `/auth/oauth/token` to receive an access token, then send it as a Bearer token on every verse request. Through Jentic, both the client credentials and the resulting access token are stored encrypted in your Jentic One instance and never enter the agent's context. ### Can I get a specific verse by chapter and verse number? Yes. GET `/api/v1/chapters/{chapter_number}/verses/{verse_number}` returns a single verse, including the Sanskrit text, transliteration, and translations or commentaries provided by the API. For example, `/api/v1/chapters/2/verses/47` returns the well-known karma yoga verse. ### How many chapters and verses are in the Bhagavad Gita API? The API covers all 18 chapters of the Bhagavad Gita and roughly 700 verses across them. GET `/api/v1/chapters` returns the chapter index; GET `/api/v1/verses` returns every verse in the corpus for bulk download. ### How do I fetch a daily verse through Jentic? Search Jentic for 'fetch a Bhagavad Gita verse', load `/api/v1/chapters/{chapter_number}/verses/{verse_number}`, and execute with the day's chapter and verse. With the SDK: pip install jentic, then SearchRequest, LoadRequest, and ExecutionRequest in an async flow. ### Is the Bhagavad Gita API free? The bhagavadgitaapi.in service is offered free for non-commercial use; client credentials are obtained from the bhagavadgita.io developer portal. Commercial usage tiers are not declared in the OpenAPI spec - contact the operators if your use case is commercial. ### Can I limit what my agent is allowed to do with the Bhagavad Gita API? Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use, so you can allow only the calls you want, such as fetching a single verse with GET `/api/v1/chapters/{chapter_number}/verses/{verse_number}` while blocking the bulk GET `/api/v1/verses` listing. Since the chapter number sits in the URL path, a rule can pin the agent to one chapter and its verses. Every operation on this API is read-only text retrieval, so no write path is reachable regardless of the set you allow.