API

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.

Base URL

https://biblija.net/api/v1

How to obtain an API key

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).

Which translations can I access? API access is currently enabled only for translations whose copyright belongs to the Bible Society of Slovenia and for translations in the public domain.

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.

Authentication

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.

Rate limit

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.

Endpoints

Examples in:

GET /translations

List 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

GET /passage

A passage by reference in the selected translation.

ParameterRequiredDescription
translationyesTranslation abbreviation (e.g. KJV, SSP).
referenceyesReference, e.g. Jn 3,16, Mt 5,1-12 or Ps 23.
formatnoText 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"]);
HTML output (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"]);

GET /verse-of-the-day

Verse 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"]);

Example response

{
  "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.

Errors

{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
CodeHTTPMeaning
missing_api_key / invalid_api_key401Missing or invalid key.
invalid_translation / missing_parameter / invalid_format400Invalid input.
reference_not_found / not_found404No match / unknown endpoint.
rate_limit_exceeded429Daily limit exceeded.

← Back to home