Skip to main content

​
POST /api/verse

Fetch a specific verse from the Bhagavad Gita by chapter and verse number.

​
Request

​
chapter
integer
required
Chapter number. Must be between 1 and 18.
​
verse
integer
required
Verse number within the chapter. Must be between 1 and 78 (maximum verses in chapter 18).

​
Request Body Example

{
  "chapter": 2,
  "verse": 47
}

​
Response

​
status
string
Response status - always “success” for successful requests
​
data
object
Object containing verse details
​
data.chapter
integer
Chapter number (1-18)
​
data.verse
integer
Verse number within the chapter
​
data.translation
string
English translation of the verse
​
data.summarized_commentary
string
Summary commentary on the verse

​
Response Example

{
  "status": "success",
  "data": {
    "chapter": 2,
    "verse": 47,
    "translation": "You have the right to perform your prescribed duties, but you are not entitled to the fruits of your actions. Never consider yourself to be the cause of the results of your activities, nor be attached to inaction.",
    "summarized_commentary": "This verse teaches the principle of performing duty without attachment to results."
  }
}

​
Error Responses

Status CodeDescription
400Invalid request - missing chapter/verse or values out of range
404Verse not found
429Rate limit exceeded
500Internal server error
504Request timeout (>15 seconds)

​
Rate Limiting

  • Frontend: 60 requests per minute per client
  • Backend: 30 requests per minute per IP address

​
Code Examples

curl -X POST https://gitachat.org/api/verse \
  -H "Content-Type: application/json" \
  -d '{
    "chapter": 2,
    "verse": 47
  }'

​
Verse Ranges by Chapter

The Bhagavad Gita contains 18 chapters with varying numbers of verses:
  • Each chapter has a different number of verses
  • The maximum verse number varies by chapter
  • Chapter 18 has the most verses (78 verses)
  • Valid chapter range: 1-18
  • Valid verse range: 1-78 (depending on chapter)

Build docs developers (and LLMs) love

Get started for freeTalk to us