Spanish Bible API API Reference

An API to query spanish (Reina Valera 1960) bible verses and books.

API Endpoint
https://bible-app-demo.herokuapp.com/api
Contact: alphaelena@gmail.com
Schemes: https
Version: 2.0

Paths

GET /books

Return a list of bible books

200 OK

Success response

Response Content-Types: application/json
Response Example (200 OK)
[
  {
    "id": "string",
    "testament": "string",
    "name": "string",
    "chapters": [
      {
        "id": "string",
        "osis_end": "string",
        "chapter": "string"
      }
    ]
  }
]

GET /book/{bookId}

Returns a single book given a bookId

bookId: string
in path

(no description)

200 OK

Success response

Response Content-Types: application/json
Response Example (200 OK)
{
  "id": "string",
  "testament": "string",
  "name": "string",
  "chapters": [
    {
      "id": "string",
      "osis_end": "string",
      "chapter": "string"
    }
  ]
}

GET /book/{bookId}/verses/{range}

Return a list of verses of a given bookId and a range in the format: startChapterNumber:startVerseNumber-endChapterNumber:endVerseNumber

bookId: string
in path

(no description)

range: string
in path

Example ranges: [1, 1:10, 1:10-2, 1:10-2:5, 1-3]

200 OK

Success response

Response Content-Types: application/json
Response Example (200 OK)
[
  {
    "id": "string",
    "cleanText": "string",
    "reference": "string",
    "text": "string",
    "chapterId": "string"
  }
]

Schema Definitions

Books: array

object
id: string
testament: string

OT = Old testament, NT = New Testament

name: string
chapters: object[]
object
id: string
osis_end: string

Represents the last verse in the chapter

chapter: string
Example
[
  {
    "id": "string",
    "testament": "string",
    "name": "string",
    "chapters": [
      {
        "id": "string",
        "osis_end": "string",
        "chapter": "string"
      }
    ]
  }
]

Book: object

id: string
testament: string

OT = Old testament, NT = New Testament

name: string
chapters: object[]
object
id: string
osis_end: string

Represents the last verse id in the chapter

chapter: string
Example
{
  "id": "string",
  "testament": "string",
  "name": "string",
  "chapters": [
    {
      "id": "string",
      "osis_end": "string",
      "chapter": "string"
    }
  ]
}

Verses: array

object
id: string
cleanText: string
reference: string
text: string
chapterId: string

The chapter of the book the verse belongs to

Example
[
  {
    "id": "string",
    "cleanText": "string",
    "reference": "string",
    "text": "string",
    "chapterId": "string"
  }
]