Skip to content

Verses

Get individual verses by their unique ID.

Get a Verse

Retrieve a specific verse by its ID.

GET /v1/verses/:id

Parameters

ParameterTypeDescription
idstringVerse ID in format book_chapter_verse (e.g., "joh_3_16")

Query Parameters

ParameterTypeRequiredDescription
versionstringNoVersion ID (defaults to "rvr60")

Response

json
{
  "success": true,
  "data": {
    "verse": {
      "id": "joh_3_16",
      "book": {
        "id": "joh",
        "name": "Juan",
        "abbreviation": "JN"
      },
      "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."
    },
    "version": {
      "id": "rvr60",
      "name": "Reina-Valera 1960"
    }
  }
}

Example

bash
curl "https://api.apibiblia.com/v1/verses/joh_3_16?version=rvr60" \
  -H "X-API-Key: YOUR_API_KEY"

Verse ID Format

Verse IDs follow the pattern {book_id}_{chapter}_{verse}:

ReferenceVerse ID
Genesis 1:1gen_1_1
Psalm 23:1psa_23_1
John 3:16joh_3_16
Romans 8:28rom_8_28

The response includes navigation to adjacent verses:

json
{
  "data": {
    "verse": {
      "id": "joh_3_16",
      "previous": {
        "id": "joh_3_15",
        "reference": "Juan 3:15"
      },
      "next": {
        "id": "joh_3_17",
        "reference": "Juan 3:17"
      }
    }
  }
}

When to Use This Endpoint

Use the /v1/verses/:id endpoint when:

  • You have a verse ID from a previous API response
  • You need to fetch a specific verse by its unique identifier
  • Building navigation between individual verses

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

Passages vs Verses

  • Passages (/v1/passage): Use natural references like "John 3:16"
  • Verses (/v1/verses/:id): Use verse IDs like "joh_3_16"

Built on Cloudflare's global edge network.