Verses
Get individual verses by their unique ID.
Get a Verse
Retrieve a specific verse by its ID.
GET /v1/verses/:idParameters
| Parameter | Type | Description |
|---|---|---|
id | string | Verse ID in format book_chapter_verse (e.g., "joh_3_16") |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
version | string | No | Version 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}:
| Reference | Verse ID |
|---|---|
| Genesis 1:1 | gen_1_1 |
| Psalm 23:1 | psa_23_1 |
| John 3:16 | joh_3_16 |
| Romans 8:28 | rom_8_28 |
Navigation
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"