Books

List books in a Bible version.

List Books

Get all books in a specific Bible version.

GET /v1/books

Query Parameters

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

Response

{
  "success": true,
  "data": {
    "version": "RVR1960",
    "books": [
      {
        "id": "gen",
        "name": "Génesis",
        "abbreviation": "GEN",
        "abbreviation_local": "GN",
        "testament": "OT",
        "book_number": 1,
        "chapter_count": 50
      },
      {
        "id": "exo",
        "name": "Éxodo",
        "abbreviation": "EXO",
        "abbreviation_local": "EX",
        "testament": "OT",
        "book_number": 2,
        "chapter_count": 40
      }
    ]
  }
}

Response Fields

Field	Description
abbreviation	Standard abbreviation for API calls (e.g., "GEN", "DEU", "JHN")
abbreviation_local	Localized abbreviation for display (e.g., "GN", "DT", "JN" in Spanish)

Using Abbreviations

When making API calls to /chapters or /verses, always use the abbreviation field (standard format), not abbreviation_local.

Example

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

Get a Specific Book

Get details about a specific book.

GET /v1/books/:id

Parameters

Parameter	Type	Description
id	string	The book ID (e.g., "gen", "mat")

Query Parameters

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

Response

{
  "success": true,
  "data": {
    "book": {
      "id": "mat",
      "name": "Mateo",
      "abbreviation": "MT",
      "testament": "NT",
      "book_number": 40,
      "chapter_count": 28,
      "chapters": [
        { "number": 1, "verse_count": 25 },
        { "number": 2, "verse_count": 23 }
      ]
    }
  }
}

Book IDs

Old Testament

ID	Book
gen	Genesis
exo	Exodus
lev	Leviticus
num	Numbers
deu	Deuteronomy
...	...

New Testament

ID	Book
mat	Matthew
mar	Mark
luk	Luke
joh	John
act	Acts
...	...