A REST API for accessing Bible texts, the verse of the day and the list of translations. Responses are in JSON format (UTF-8). Access is intended for mission partners of the Bible Society of Slovenia.
https://biblija.net/api/v1
API keys are granted to parishes, communities and other partner organisations of the Bible Society of Slovenia upon request. To request a key, write to us via the contact form and describe your intended use: what application or service you are building, which translations you are interested in and the expected request volume.
Approving a request requires signing an agreement with the Bible Society of Slovenia, which sets out the terms of use, source attribution and so on. Once we approve your request, the option to generate and regenerate a key appears in your profile (sign-in required).
The Bible Society of Slovenia is the steward of the Slovenian Bible translations. This includes guarding against the misuse of biblical texts by individuals or groups whose aims run counter to the mission of the Bible Society and the churches associated with it.
Every request requires an API key. Send it in the header:
Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx
The X-API-Key: <key> header is also supported as an alternative. Never send the key in the URL.
100 requests per day per key. Every response contains the headers X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. When the limit is exceeded, it returns 429 and the Retry-After header.
/translationsList of available translations (with the abbreviations for the translation parameter).
curl -H "Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" \
"https://biblija.net/api/v1/translations"const res = await fetch("https://biblija.net/api/v1/translations", {
headers: { Authorization: "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" }
});
if (!res.ok) throw new Error((await res.json()).error.message);
const { data } = await res.json();
console.log(data);import requests
r = requests.get(
"https://biblija.net/api/v1/translations",
headers={"Authorization": "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"}, timeout=10)
r.raise_for_status()
print(r.json()["data"])<?php
$ch = curl_init("https://biblija.net/api/v1/translations");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"],
]);
$data = json_decode(curl_exec($ch), true);
print_r($data["data"]);There are currently 28 translations available via the API. This list is always up to date and matches the response of the endpoint above:
| Abbreviation | Name | Language |
|---|---|---|
SSP |
Slovenian Standard Version | SLV |
SSP-Op |
SSP - Study notes | SL |
SSP-Ref |
SSP - Cross References | SL |
ŽJ |
Life with Jesus NT | SLV |
JUB |
Jubilee Translation | SLV |
EKU |
Ecumenical Edition | SLV |
CHR |
Chraska Bible | SLV |
BSB |
Berean Standard Bible | ENG |
KJV |
King James Version | ENG |
ASV |
American Standard Version | ENG |
SEG |
Louis Segond (1910) | FR |
RUS |
Russian Synodal Version (1876) | RU |
DAL |
Dalmatin Bible (1584) | SLV |
LUT45 |
Luther (1545) | DE |
LUT12 |
Luther (1912) | DEU |
WEB |
World English Bible | ENG |
WLF |
Wolfova Biblija (1856-59) | SL |
JAP |
Japljeva Biblija (1784-1802) | SL |
VLC |
Vulgata Clementina (1592) | LA |
TRB |
Trubarjeva NZ in Ps (1555-1577) | SL |
PREK28 |
Prekmurian NT and Ps (1928) | SLV |
GWH |
Greek New Testament Westcott-Hort (1885) | GRC |
GTR |
Greek Textus Receptus | GRC |
LXX-Eng |
Brenton English LXX (1851) | ENG |
LXX-Sl |
Septuagint (Slovenian Edition 2026) | GRC |
LXX-Sl-A |
Septuagint (Slovenian Edition 2026), alternative texts | GRC |
LXX-Br |
Brenton Septuagint (1851) | GRC |
HEB |
Hebrew Old Testament | HBO |
/passageA passage by reference in the selected translation.
| Parameter | Required | Description |
|---|---|---|
translation | yes | Translation abbreviation (e.g. KJV, SSP). |
reference | yes | Reference, e.g. Jn 3,16, Mt 5,1-12 or Ps 23. |
format | no | Text format: text (default, plain text), html (our HTML markup) or both. |
curl -H "Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" \
"https://biblija.net/api/v1/passage?translation=KJV&reference=Jn%203,16"const res = await fetch("https://biblija.net/api/v1/passage?translation=KJV&reference=Jn%203,16", {
headers: { Authorization: "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" }
});
if (!res.ok) throw new Error((await res.json()).error.message);
const { data } = await res.json();
console.log(data);import requests
r = requests.get(
"https://biblija.net/api/v1/passage?translation=KJV&reference=Jn%203,16",
headers={"Authorization": "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"}, timeout=10)
r.raise_for_status()
print(r.json()["data"])<?php
$ch = curl_init("https://biblija.net/api/v1/passage?translation=KJV&reference=Jn%203,16");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"],
]);
$data = json_decode(curl_exec($ch), true);
print_r($data["data"]);format=html or both). Each verse gets an html field (rendered markup: names of God <span class="nd">, added text <span class="add">, poetic paragraphs <span class="q1"> …), and the whole passage gets an html field with section headings and numbered verses (<span class="verse"><sup class="verse-num">). We return markup only, without CSS — styling (e.g. poetry indents, colour of God's names) is left up to you. Footnotes and cross-references are not included in the HTML. curl -H "Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" \
"https://biblija.net/api/v1/passage?translation=SSP&reference=Mt%205,1-3&format=html"const res = await fetch("https://biblija.net/api/v1/passage?translation=SSP&reference=Mt%205,1-3&format=html", {
headers: { Authorization: "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" }
});
if (!res.ok) throw new Error((await res.json()).error.message);
const { data } = await res.json();
console.log(data);import requests
r = requests.get(
"https://biblija.net/api/v1/passage?translation=SSP&reference=Mt%205,1-3&format=html",
headers={"Authorization": "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"}, timeout=10)
r.raise_for_status()
print(r.json()["data"])<?php
$ch = curl_init("https://biblija.net/api/v1/passage?translation=SSP&reference=Mt%205,1-3&format=html");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"],
]);
$data = json_decode(curl_exec($ch), true);
print_r($data["data"]);/verse-of-the-dayVerse of the day. Optional translation parameter (default SSP).
curl -H "Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" \
"https://biblija.net/api/v1/verse-of-the-day?translation=KJV"const res = await fetch("https://biblija.net/api/v1/verse-of-the-day?translation=KJV", {
headers: { Authorization: "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" }
});
if (!res.ok) throw new Error((await res.json()).error.message);
const { data } = await res.json();
console.log(data);import requests
r = requests.get(
"https://biblija.net/api/v1/verse-of-the-day?translation=KJV",
headers={"Authorization": "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"}, timeout=10)
r.raise_for_status()
print(r.json()["data"])<?php
$ch = curl_init("https://biblija.net/api/v1/verse-of-the-day?translation=KJV");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"],
]);
$data = json_decode(curl_exec($ch), true);
print_r($data["data"]);{
"data": {
"reference": "Jn 3,16",
"translation": { "abbreviation": "KJV", "name": "King James Version", "language": "eng" },
"verses": [
{
"book": "John", "book_abbrev": "Jhn", "chapter": 3, "verse": 16,
"reference": "Jhn 3,16",
"text": "For God so loved the world, ..."
}
],
"copyright": "Public Domain"
}
}
With format=html each verse has an html field instead of text, and the response additionally has the passage html (headings + numbered verses):
{
"data": {
"reference": "Mt 5,1-3",
"translation": { "abbreviation": "SSP", "name": "...", "language": "slv" },
"verses": [
{ "book": "Matej", "book_abbrev": "Mt", "chapter": 5, "verse": 1,
"reference": "Mt 5,1",
"html": "Ko je zagledal množice, se je povzpel na goro. ..." }
],
"html": "<h3 class=\"ms1\">Govor na gori</h3>\n<span class=\"verse\" data-ref=\"Mt 5,1\"><sup class=\"verse-num\">1</sup> Ko je zagledal množice ...</span>",
"copyright": "..."
}
}
For books whose printed chapter label differs from the internal sequence (Greek Esther: A, B, C …), reference uses the printed label and the verse carries an extra chapter_label field; chapter stays the internal number.
{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
| Code | HTTP | Meaning |
|---|---|---|
missing_api_key / invalid_api_key | 401 | Missing or invalid key. |
invalid_translation / missing_parameter / invalid_format | 400 | Invalid input. |
reference_not_found / not_found | 404 | No match / unknown endpoint. |
rate_limit_exceeded | 429 | Daily limit exceeded. |