The Free Bible API


„Freely you have received; freely give.”
- Matthew 10:8b (NIV)


The goal of our Bible API is to provide Bible translations as open and as accessible as possible. Feel free to use this API in your projects, web applications, mobile and desktop applications. This API supports the JSON format. There is no limitation as long as the biblical content remains unchanged. To start browsing the API, use the following endpoint: https://bible4u.net/api/v1.


Supported Formats


Currently, following formats are supported: JSON (default), XML and Yaml. To query response in specific format, simple use parameter ?format=<value>, where <value> is json, xml or yaml. Example: https://bible4u.net/api/v1?format=xml


Use Cases

Retrieve a list of Bibles

Sample request

GET https://bible4u.net/api/v1/bibles HTTP/1.1
Accept: application/json
Sample response

{
  "data": [
    {
      "apiUrl": "https://bible4u.net/api/v1/bibles/KJV",
      "copytightInfo": "",
      "langId": "en",
      "language": "English (EN)",
      "name": "King James Version (KJV)",
      "publisher": "Public Domain",
      "ref": "KJV"
    },
    {
      "apiUrl": "https://bible4u.net/api/v1/bibles/RNKJV",
      "copytightInfo": "",
      "langId": "en",
      "language": "English (EN)",
      "name": "Restored Name King James Version",
      "publisher": "Public Domain",
      "ref": "RNKJV"
    }
  ],
  "success": true
}
                    
Retrieve info about Bible books

Sample request

GET https://bible4u.net/api/v1/bibles/KJV HTTP/1.1
Accept: application/json
Sample response

{
  "data": {
    "apiUrl": "https://bible4u.net/api/v1/bibles/KJV",
    "books": [
      {
        "apiUrl": "https://bible4u.net/api/v1/bibles/KJV/books/Gen",
        "chaptersCount": 50,
        "name": "Genesis",
        "order": 0,
        "ref": "Gen"
      },
      ...
    ],
    "copytightInfo": "",
    "langId": "en",
    "language": "English (EN)",
    "name": "King James Version (KJV)",
    "publisher": "Public Domain",
    "ref": "KJV"
  },
  "success": true
}
Retrieve verses of Bible chapter

Sample request

GET https://bible4u.net/api/v1/bibles/KJV/books/Gen/chapters/1 HTTP/1.1
Accept: application/json
Sample response

{
  "data": {
    "apiUrl": "https://bible4u.net/api/v1/bibles/KJV/books/Gen/chapters/1",
    "ref": 1,
    "verses": [
      {
        "ref": "1",
        "text": "In the beginning God created the heaven and the earth."
      },
      {
        "ref": "2",
        "text": "And the earth was without form, and void; and darkness was upon the face of the deep. And the Spirit of God moved upon the face of the waters."
      },
      ...
    ]
  },
  "success": true
}
Retrieve specific Bible passage

Sample request

GET https://bible4u.net/api/v1/passage/KJV/Gen?start-chapter=1&start-verse=1&end-verse=5 HTTP/1.1
Accept: application/json
Sample response

{
  "data": {
    "bibleRef": "KJV",
    "bookRef": "Gen",
    "endChapter": 1,
    "endVerse": 5,
    "startChapter": 1,
    "startVerse": 1,
    "verses": [
      {
        "chapter": 1,
        "text": "In the beginning God created the heaven and the earth.",
        "verse": 1
      },
      {
        "chapter": 1,
        "text": "And the earth was without form, and void; and darkness was upon the face of the deep. And the Spirit of God moved upon the face of the waters.",
        "verse": 2
      },
      {
        "chapter": 1,
        "text": "And God said, Let there be light: and there was light.",
        "verse": 3
      },
      {
        "chapter": 1,
        "text": "And God saw the light, that it was good: and God divided the light from the darkness.",
        "verse": 4
      },
      {
        "chapter": 1,
        "text": "And God called the light Day, and the darkness he called Night. And the evening and the morning were the first day.",
        "verse": 5
      }
    ]
  },
  "success": true
}