Authentication

API.Bible allows any developer to include Scripture content and text anywhere in their website or application for non-commercial purposes.

Creating an Account

Before you can access the API you must first create an Account to retrieve your own personalized API key. Head on over to our sign up page to get started.

Once your application has been approved you can find your API key in your Dashboard settings.

If at any point you need further assistance, please visit our support page!

Accessing the API

Authenticate your account when using the API by including your secret API key in each request. You can manage your API keys your account's dashboard. Your API keys carry many privileges, so be sure to keep them private.

The authentication process uses a variation of HTTP Basic Auth. For each request you must place your private key into the api-key header

cURL

curl --request GET \
--url https://api.scripture.api.bible/v1/bibles \
--header 'api-key: test_okikJOvBiI2HlWgH4'

Suggest Edits

Errors

The API uses the following response status codes, as defined in the RFC 2616 and RFC 6585.

Code

Reason

200

Success

400

Invalid ID supplied

401

The API key provided is either missing, invalid, or unauthorized for API access.

403

Server understood the request, but provided API key is not authorized to retrieve this information.

404

Resource not found.

Suggest Edits

Rate Limiting

The API.Bible allows any developer to include Scripture content and text anywhere in their website or application for non-commercial purposes.

API.Bible is free for non-commercial usage. The API is rate limited to prevent abuse that would degrade our ability to maintain consistent API performance for all users. Each registered API key or app is allowed to request up to 500 consecutive verses at a time and make 5,000 queries per day. A registered API key or app associated with a domain name on the .BIBLE top-level domain may exceed the daily query limit.

If you are interested in commercial usage or more access, contact us!

Suggest Edits

Versioning

When we make backwards-incompatible changes to the API, we release new versions. The version is indicated in the URI using a path prefix. The current version is v1.

Below is an example URI. Notice the included v1:
https://api.scripture.api.bible/v1/bibles

Suggest Edits

Bibles

Suggest Edits

/v1/bibles

Gets an array of Bible objects authorized for current API Key

gethttps://api.scripture.api.bible/v1/bibles

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Query Params

language

string

ISO 639-3 three digit langage code used to filter results

abbreviation

string

Bible abbreviation to search for

name

string

Bible name to search for

ids

string

Comma separated list of Bible Ids to return

Response

Successful response

data	array

Suggest Edits

/v1/bibles/{bibleId}

Gets a single Bible for a given bibleId

gethttps://api.scripture.api.bible/v1/bibles/bibleId

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible to be fetched

Response

Successful response

data	object
data.id	string
data.dblId	string
data.abbreviation	string
data.abbreviationLocal	string
data.copyright	string
data.language	object
data.language.id	string
data.language.name	string
data.language.nameLocal	string
data.language.script	string
data.language.scriptDirection	string
data.countries	array
data.name	string
data.nameLocal	string
data.description	string
data.descriptionLocal	string
data.info	string
data.type	string
data.updatedAt	string
data.relatedDbl	string
data.audioBibles	array

Suggest Edits

/v1/audio-bibles

Gets an array of audio Bible objects authorized for current API Key

gethttps://api.scripture.api.bible/v1/audio-bibles

curl --request GET \
  --url https://api.scripture.api.bible/v1/audio-bibles

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/audio-bibles' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/audio-bibles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/audio-bibles");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/audio-bibles"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Query Params

language

string

ISO 639-3 three digit langage code used to filter results

abbreviation

string

Bible abbreviation to search for

name

string

Bible name to search for

ids

string

Comma separated list of Bible Ids to return

bibleId

string

bibleId of related text Bible used to filter audio bible results

Response

Successful response

data	array

Suggest Edits

/v1/audio-bibles/{audioBibleId}

Gets a single audio Bible for a given audioBibleId

gethttps://api.scripture.api.bible/v1/audio-bibles/audioBibleId

curl --request GET \
  --url https://api.scripture.api.bible/v1/audio-bibles/audioBibleId

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/audio-bibles/audioBibleId' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/audio-bibles/audioBibleId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/audio-bibles/audioBibleId");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/audio-bibles/audioBibleId"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

audioBibleId

string

required

Id of audio Bible to be fetched

Response

Successful response

data	object
data.id	string
data.dblId	string
data.abbreviation	string
data.abbreviationLocal	string
data.copyright	string
data.language	object
data.language.id	string
data.language.name	string
data.language.nameLocal	string
data.language.script	string
data.language.scriptDirection	string
data.countries	array
data.name	string
data.nameLocal	string
data.description	string
data.descriptionLocal	string
data.info	string
data.type	string
data.updatedAt	string
data.relatedDbl	string

Suggest Edits

Books

Suggest Edits

/v1/bibles/{bibleId}/books

Gets an array of Book objects for a given bibleId

gethttps://api.scripture.api.bible/v1/bibles/bibleId/books

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/books

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/books' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/books")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/books");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/books"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible whose Book to fetch

Query Params

include-chapters

boolean

Boolean indicating if an array of chapter summaries should be
included in the results. Defaults to false.

include-chapters-and-sections

boolean

Boolean indicating if an array of chapter summaries and an array
of sections should be included in the results. Defaults to false.

Response

Successful response

data	array

Suggest Edits

/v1/bibles/{bibleId}/books/{bookId}

Gets a single Book object for a given bibleId and bookId

gethttps://api.scripture.api.bible/v1/bibles/bibleId/books/bookId

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible whose Book to fetch

bookId

string

required

Id of the Book to fetch

Query Params

include-chapters

boolean

Boolean indicating if an array of chapter summaries should be
included in the results. Defaults to false.

Response

Successful response

data	object
data.id	string
data.bibleId	string
data.abbreviation	string
data.name	string
data.nameLong	string
data.chapters	array

Suggest Edits

/v1/audio-bibles/{audioBibleId}/books

Gets an array of Book objects for a given audioBibleId

gethttps://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books

curl --request GET \
  --url https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

audioBibleId

string

required

Id of audio Bible whose Book to fetch

Query Params

include-chapters

boolean

Boolean indicating if an array of chapter summaries should be
included in the results. Defaults to false.

include-chapters-and-sections

boolean

Boolean indicating if an array of chapter summaries and an array
of sections should be included in the results. Defaults to false.

Response

Successful response

data	array

Suggest Edits

/v1/audio-bibles/{audioBibleId}/books/{bookId}

Gets a single Book object for a given audioBibleId and bookId

gethttps://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId

curl --request GET \
  --url https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

audioBibleId

string

required

Id of audio Bible whose Book to fetch

bookId

string

required

Id of the Book to fetch

Query Params

include-chapters

boolean

Boolean indicating if an array of chapter summaries should be
included in the results. Defaults to false.

Response

Successful response

data	object
data.id	string
data.bibleId	string
data.abbreviation	string
data.name	string
data.nameLong	string
data.chapters	array

Suggest Edits

Chapters

Suggest Edits

/v1/bibles/{bibleId}/books/{bookId}/chapters

Gets an array of Chapter objects for a given bibleId and bookId

gethttps://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/chapters

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/chapters

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/chapters' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/chapters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/chapters");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/chapters"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible whose Chapters to fetch

bookId

string

required

Id of the Book whose Chapters to fetch

Response

Successful response

data	array

Suggest Edits

/v1/bibles/{bibleId}/chapters/{chapterId}

Gets a single Chapter object for a given bibleId and chapterId.
This Chapter object also includes an content property with all verses for the Chapter.

gethttps://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible whose Chapter to fetch

chapterId

string

required

Id of the Chapter to fetch

Query Params

content-type

string

Content type to be returned in the content property. Supported values are html (default), json (beta), and text (beta)

include-notes

boolean

Include footnotes in content

include-titles

boolean

Include section titles in content

include-chapter-numbers

boolean

Include chapter numbers in content

include-verse-numbers

boolean

Include verse numbers in content.

include-verse-spans

boolean

Include spans that wrap verse numbers and verse text for bible content.

parallels

string

Comma delimited list of bibleIds to include

Response

Successful response

data	object
data.id	string
data.bibleId	string
data.number	string
data.bookId	string
data.content	string
data.reference	string
data.next	object
data.next.id	string
data.next.bookId	string
data.next.number	string
data.previous	object
data.previous.id	string
data.previous.bookId	string
data.previous.number	string
data.copyright	string
meta	object
meta.fums	string
meta.fumsId	string
meta.fumsJsInclude	string
meta.fumsJs	string
meta.fumsNoScript	string

Suggest Edits

/v1/audio-bibles/{audioBibleId}/books/{bookId}/chapters

Gets an array of Chapter objects for a given audioBibleId and bookId

gethttps://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId/chapters

curl --request GET \
  --url https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId/chapters

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId/chapters' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId/chapters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId/chapters");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/books/bookId/chapters"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

audioBibleId

string

required

Id of Bible whose Chapters to fetch

bookId

string

required

Id of the Book whose Chapters to fetch

Response

Successful response

data	array

Suggest Edits

/v1/audio-bibles/{audioBibleId}/chapters/{chapterId}

Gets a single Chapter object for a given audioBibleId and chapterId.
This AudioChapter object also includes an resourceUrl property with a HTTP URL
to the mp3 audio resource for the chapter. The resourceUrl is unique per request
and expires in XX minutes. The expiresAt property provides the Unix time value of
resourceUrl expiration.

gethttps://api.scripture.api.bible/v1/audio-bibles/audioBibleId/chapters/chapterId

curl --request GET \
  --url https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/chapters/chapterId

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/chapters/chapterId' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/chapters/chapterId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/chapters/chapterId");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/audio-bibles/audioBibleId/chapters/chapterId"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

audioBibleId

string

required

Id of Bible whose Chapter to fetch

chapterId

string

required

Id of the Chapter to fetch

Response

Successful response

data	object
data.id	string
data.bibleId	string
data.number	string
data.bookId	string
data.resourceUrl	string
data.expiresAt	integer
data.reference	string
data.next	object
data.next.id	string
data.next.bookId	string
data.next.number	string
data.previous	object
data.previous.id	string
data.previous.bookId	string
data.previous.number	string
data.copyright	string
meta	object
meta.fums	string
meta.fumsId	string
meta.fumsJsInclude	string
meta.fumsJs	string
meta.fumsNoScript	string

Suggest Edits

Passages

Suggest Edits

/v1/bibles/{bibleId}/passages/{passageId}

Gets a Passage object for a given bibleId and passageId. This
Passage object also includes an content property with all verses
corresponding to the passageId.
The passageId parameter can represent a chapter, verse, or range of verses.

gethttps://api.scripture.api.bible/v1/bibles/bibleId/passages/passageId

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/passages/passageId

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/passages/passageId' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/passages/passageId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/passages/passageId");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/passages/passageId"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible for passage

passageId

string

required

String reference id for the requested passage.

Query Params

content-type

string

Content type to be returned in the content property. Supported values are html (default), json (beta), and text (beta)

include-notes

boolean

Include footnotes in content

include-titles

boolean

Include section titles in content

include-chapter-numbers

boolean

Include chapter numbers in content

include-verse-numbers

boolean

Include verse numbers in content.

include-verse-spans

boolean

Include spans that wrap verse numbers and verse text for bible content.

parallels

string

Comma delimited list of bibleIds to include

use-org-id

boolean

Use the supplied id(s) to match the verseOrgId instead of the verseId

Response

Successful response

data	object
data.id	string
data.bibleId	string
data.orgId	string
data.content	string
data.reference	string
data.copyright	string
meta	object
meta.fums	string
meta.fumsId	string
meta.fumsJsInclude	string
meta.fumsJs	string
meta.fumsNoScript	string

Suggest Edits

Sections

Suggest Edits

/v1/bibles/{bibleId}/books/{bookId}/sections

Gets an array of Section objects for a given bibleId and bookId

gethttps://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/sections

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/sections

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/sections' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/sections")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/sections");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/books/bookId/sections"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible whose Sections to fetch

bookId

string

required

Id of the Book whose Sections to fetch

Response

Successful response

data	array

Suggest Edits

/v1/bibles/{bibleId}/chapters/{chapterId}/sections

Gets an array of Section objects for a given bibleId and chapterId

gethttps://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/sections

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/sections

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/sections' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/sections")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/sections");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/sections"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible whose Sections to fetch

chapterId

string

required

Id of the Chapter whose Sections to fetch

Response

Successful response

data	array

Suggest Edits

/v1/bibles/{bibleId}/sections/{sectionId}

Gets a single Section object for a given bibleId and sectionId. This Section
object also includes an content property with all verses for the Section.

gethttps://api.scripture.api.bible/v1/bibles/bibleId/sections/sectionId

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/sections/sectionId

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/sections/sectionId' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/sections/sectionId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/sections/sectionId");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/sections/sectionId"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible whose Section to fetch

sectionId

string

required

Id of the Section to fetch

Query Params

content-type

string

Content type to be returned in the content property. Supported values are html (default), json (beta), and text (beta)

include-notes

boolean

Include footnotes in content

include-titles

boolean

Include section titles in content

include-chapter-numbers

boolean

Include chapter numbers in content

include-verse-numbers

boolean

Include verse numbers in content.

include-verse-spans

boolean

Include spans that wrap verse numbers and verse text for bible content.

parallels

string

Comma delimited list of bibleIds to include

Response

Successful response

data	object
data.id	string
data.bibleId	string
data.bookId	string
data.chapterId	string
data.title	string
data.content	string
data.firstVerseId	string
data.lastVerseId	string
data.firstVerseOrgId	string
data.lastVerseOrgId	string
data.copyright	string
data.next	object
data.next.id	string
data.next.title	string
data.previous	object
data.previous.id	string
data.previous.title	string
meta	object
meta.fums	string
meta.fumsId	string
meta.fumsJsInclude	string
meta.fumsJs	string
meta.fumsNoScript	string

Suggest Edits

Verses

Suggest Edits

/v1/bibles/{bibleId}/chapters/{chapterId}/verses

Gets an array of Verse objects for a given bibleId and chapterId

gethttps://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/verses

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/verses

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/verses' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/verses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/verses");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/chapters/chapterId/verses"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible whose Verses to fetch

chapterId

string

required

Id of the Chapter whose Verses to fetch

Response

Successful response

data	array

Suggest Edits

/v1/bibles/{bibleId}/verses/{verseId}

Gets a Verse object for a given bibleId and verseId. This
Verse object also includes an content property with the verse
corresponding to the verseId.

gethttps://api.scripture.api.bible/v1/bibles/bibleId/verses/verseId

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/verses/verseId

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/verses/verseId' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/verses/verseId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/verses/verseId");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/verses/verseId"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible for passage

verseId

string

required

String reference id for the requested verse.

Query Params

content-type

string

Content type to be returned in the content property. Supported values are html (default), json (beta), and text (beta)

include-notes

boolean

Include footnotes in content

include-titles

boolean

Include section titles in content

include-chapter-numbers

boolean

Include chapter numbers in content

include-verse-numbers

boolean

Include verse numbers in content.

include-verse-spans

boolean

Include spans that wrap verse numbers and verse text for bible content.

parallels

string

Comma delimited list of bibleIds to include

use-org-id

boolean

Use the supplied id(s) to match the verseOrgId instead of the verseId

Response

Successful response

data	object
data.id	string
data.orgId	string
data.bibleId	string
data.bookId	string
data.chapterId	string
data.content	string
data.reference	string
data.copyright	string
data.next	object
data.next.id	string
data.next.bookId	string
data.previous	object
data.previous.id	string
data.previous.bookId	string
meta	object
meta.fums	string
meta.fumsId	string
meta.fumsJsInclude	string
meta.fumsJs	string
meta.fumsNoScript	string

Suggest Edits

Search

Suggest Edits

/v1/bibles/{bibleId}/search

Gets search results for a given bibleId and query string. Searches
will match all verses with the list of keywords provided in the query string.
Order of the keywords does not matter. However all keywords must be
present in a verse for it to be considered a match.
The total number of results returned from a search can be limited by populating the limit
attribute in the query string with a non-negative integer value. If no
limit value is provide a default of 10 is used.
offset can be used to traverse paginated results. So for example if you are using
the default limit of 10, using an offset of 10 will return the second page of results,
namely results 11-20.
The text property of each verse object contains only the verse text. It does not
contain footnote references. However, those can be queried directly using the
/bibles/{bibleId}/verses/{verseId} endpoint.

gethttps://api.scripture.api.bible/v1/bibles/bibleId/search

curl --request GET \
  --url https://api.scripture.api.bible/v1/bibles/bibleId/search

var request = require("request");

var options = { method: 'GET',
  url: 'https://api.scripture.api.bible/v1/bibles/bibleId/search' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

require 'uri'
require 'net/http'

url = URI("https://api.scripture.api.bible/v1/bibles/bibleId/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.scripture.api.bible/v1/bibles/bibleId/search");

xhr.send(data);

import requests

url = "https://api.scripture.api.bible/v1/bibles/bibleId/search"

response = requests.request("GET", url)

print(response.text)

{{ results.statusCode[0] }} {{ results.statusCode[1] }}

Metadata

A binary file was returned

You couldn't be authenticated

Method

URL

Request Headers

{{ results.requestHeaders }}

Request Data

{{ results.data }}

Status

Response Headers

{{ results.responseHeaders }}

Try the API to see results

Path Params

bibleId

string

required

Id of Bible to search

Query Params

query

string

Search keywords or passage reference. Supported wildcards are and ?.
The wildcard matches any character sequence (e.g. searching for "wo*d" finds text such as "word", "world", and "worshipped").
The ? wildcard matches any matches any single character (e.g. searching for "l?ve" finds text such as "live" and "love").

limit

integer

Integer limit for how many matching results to return. Default is 10.

offset

integer

Offset for search results. Used to paginate results

sort

string

Sort order of results. Supported values are relevance (default), canonical and reverse-canonical

range

string

One or more, comma seperated, passage ids (book, chapter, verse) which the search will be limited to. (i.e. gen.1,gen.5 or gen-num or gen.1.1-gen.3.5)

fuzziness

string

Sets the fuzziness of a search to account for misspellings. Values can be 0, 1, 2, or AUTO. Defaults to AUTO which varies depending on the

Response

Successful response

query	string
data	object
data.query	string
data.limit	integer
data.offset	integer
data.total	integer
data.verses	array
data.passages	array
meta	object
meta.fums	string
meta.fumsId	string
meta.fumsJsInclude	string
meta.fumsJs	string
meta.fumsNoScript	string

Creating an Account

Accessing the API

Header Auth

Query Params

200400401Response

Header Auth

Path Params

200400401403404Response

Header Auth

Query Params

200400401Response

Header Auth

Path Params

200400401403404Response

Header Auth

Path Params

Query Params

200400401403Response

Header Auth

Path Params

Query Params

200400401403404Response

Header Auth

Path Params

Query Params

200400401403Response

Header Auth

Path Params

Query Params

200400401403404Response

Header Auth

Path Params

200400401403404Response

Header Auth

Path Params

Query Params

200400401403404Response

Header Auth

Path Params

200400401403404Response

Header Auth

Path Params

200400401403404Response

Header Auth

Path Params

Query Params

200400401403404Response

Header Auth

Path Params

200400401403404Response

Header Auth

Path Params

200400401403404Response

Header Auth

Path Params

Query Params

200400401403404Response

Header Auth

Path Params

200400401403404Response

Header Auth

Path Params

Query Params

200400401403404Response

Header Auth

Path Params

Query Params

200400401403404Response

Response

Response

Response

Response

Response

Response

Response

Response

Response

Response

Response

Response

Response

Response

Response

Response

Response

Response

Response