Bolls API Documentation

This documentation is called to provide an available API for creating a functioning client.

Fetching Bible text

Firstly, to fetch Bible text, you need to get a list of available translations and an object with their books. The translations list contain nodes, which have the next properties:

The books object (or list) contains books, which contain nodes, which have the next properties:

Then, using that data, you can form a url for fetching a chapter of certain translation and book. The url constructor is the next:<slug:translation>/<int:book>/<int:chapter>/

Where <slug:translation> is a translation abbreviation like YLT or UBIO or SYNOD, and where <int:book> and<int:chapter> is just a number of a book and a number of a chapter. For example by the next url you will got an eight chapter of Song of Solomon book:

The result of this request will be a list of verses of that chapter, where every verse will has some several fields.


To find verses by a slug or a string you need to form a url in the next manner:<slug:translation>/<str:piece>/

Where <slug:translation> is a translation in which you want to find something. The <str:piece> is a piece of text which can be a slug or a string which you look for. It is`not case sensitive, and it can be anything on any language: .../WLC/שָּׁמַ֖יִם וְאֵ֥ת/, .../LXX/ὁ θεὸς τὸν/, .../UBIO/Небо та землю/, .../CUV/淵 面 黑 暗/. For example the next url will returm a list of verses, where "Haggi" word is found:

The result of this request will be a list of ALL found verses in the given translation, where every verse will has some several fields:

Get a translation

You can get full translation just quering in hte next manner:<slug:translation>/

The result of it will be an array of all verses, that belongs to the given translation. For example you can try the next link:

The structure of nodes in this array will be like in the nodes of search query

Compare versions

You can make a request for peculiar verses in peculiar translations. For example if you wanna see some exact verse or verses in different translation to compare them you can use this api. The request should POST, and you should pass in the body an object with some fields

The result of this request will be an array of translations where every translation is an array of requested verses, where every verse has this fields

You can also use this API to fetch single verse or a few verses of a single translation. Just pass the translation code as an iten of arrey, chanter number, book code and array with verse / verses and you will get it.