Verses

Get individual verses or verse ranges.

Get a Verse

Retrieve a specific verse using the book abbreviation, chapter, and verse number.

GET /v1/verses/:book/:chapter/:verse

Parameters

Parameter	Type	Description
book	string	Book abbreviation (e.g., "GEN", "JHN", "ROM")
chapter	number	Chapter number
verse	number	Verse number

Query Parameters

Parameter	Type	Required	Description
version	string	No	Version ID (defaults to "RVR1960")

Response

{
  "success": true,
  "data": {
    "book": {
      "name": "Juan",
      "abbreviation": "JHN"
    },
    "chapter": 3,
    "verse": 16,
    "text": "Porque de tal manera amó Dios al mundo, que ha dado a su Hijo unigénito, para que todo aquel que en él cree, no se pierda, mas tenga vida eterna."
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

Example

curl "https://api.apibiblia.com/v1/verses/JHN/3/16?version=RVR1960" \
  -H "X-API-Key: YOUR_API_KEY"

Get a Verse Range

Retrieve multiple verses at once using a range.

GET /v1/verses/:book/:chapter/:start-:end

Example

curl "https://api.apibiblia.com/v1/verses/ROM/8/28-30?version=RVR1960" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "success": true,
  "data": {
    "book": {
      "name": "Romanos",
      "abbreviation": "ROM"
    },
    "chapter": 8,
    "verses": [
      { "verse": 28, "text": "Y sabemos que a los que aman a Dios..." },
      { "verse": 29, "text": "Porque a los que antes conoció..." },
      { "verse": 30, "text": "Y a los que predestinó..." }
    ]
  }
}

Range Limit

Verse ranges are limited to 50 verses per request.

Book Abbreviations

Use standard 3-letter abbreviations from the /v1/books endpoint:

Reference	URL Path
Genesis 1:1	/verses/GEN/1/1
Psalm 23:1	/verses/PSA/23/1
John 3:16	/verses/JHN/3/16
Romans 8:28-30	/verses/ROM/8/28-30

Use Standard Abbreviations

Always use the abbreviation field from the /v1/books response (e.g., "GEN", "JHN"), not the localized abbreviation_local (e.g., "GN", "JN").

When to Use This Endpoint

Use the /v1/verses/:book/:chapter/:verse endpoint when:

• You know the exact book, chapter, and verse
• Building Bible reading apps with navigation
• Fetching specific verses programmatically

For human-readable references like "John 3:16" or "Juan 3:16", use the Passages endpoint instead.

Passages vs Verses

• Passages (/v1/passage): Use natural references like "John 3:16"
• Verses (/v1/verses/JHN/3/16): Use structured path with abbreviation