arc.dbs.org

Production server: https://arc.dbs.org/ Local development server: http://localhost:8089/ OpenAPI YAML: openapi.yaml Support: [email protected]

alphabets

GET /api/alphabets

Retrieves a list of alphabets

Request
curl https://arc.dbs.org/api/alphabets
const res = await fetch('https://arc.dbs.org/api/alphabets');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/alphabets').json()
Responses
200
GET /api/alphabets/{script}

Retrieves an alphabet by script

Parameters
Name In Type Required Description
script path yes The unique identifier for an alphabet
Request
curl https://arc.dbs.org/api/alphabets/{script}
const res = await fetch('https://arc.dbs.org/api/alphabets/{script}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/alphabets/{script}').json()
Responses
200 Detailed information about an alphabet
404 Alphabet not found

art

GET /api/art

Retrieves a list of artworks

Parameters
Name In Type Required Description
artist query string no Filter artworks by artist
book_id query string no Filter artworks by book ID
type query string no Filter artworks by type
Request
curl https://arc.dbs.org/api/art
const res = await fetch('https://arc.dbs.org/api/art');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/art').json()
Responses
200 Successful response with a list of artworks

artists

GET /api/artists

Get a list of artists

Parameters
Name In Type Required Description
movement query string no The movement to filter artists by
nationality query string no The nationality to filter artists by
Request
curl https://arc.dbs.org/api/artists
const res = await fetch('https://arc.dbs.org/api/artists');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/artists').json()
Responses
200 A list of artists
GET /api/artists/{id}

Get artist by ID

Parameters
Name In Type Required Description
id path string yes The ID of the artist to retrieve
Request
curl https://arc.dbs.org/api/artists/{id}
const res = await fetch('https://arc.dbs.org/api/artists/{id}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/artists/{id}').json()
Responses
200 An artist object

artworks

GET /api/artworks/{id}

Retrieves a specific artwork by ID

Parameters
Name In Type Required Description
id path string yes Unique identifier of the artwork to retrieve
Request
curl https://arc.dbs.org/api/artworks/{id}
const res = await fetch('https://arc.dbs.org/api/artworks/{id}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/artworks/{id}').json()
Responses
200 Successful response with the artwork details
404 Artwork not found

bible-audio

GET /api/bible-audio/

Retrieves a list of audio bibles

Request
curl https://arc.dbs.org/api/bible-audio/
const res = await fetch('https://arc.dbs.org/api/bible-audio/');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/bible-audio/').json()
Responses
200 A list of available audio bibles
GET /api/bible-audio/{id}

Retrieves an audio bible by ID

Parameters
Name In Type Required Description
id path string yes The unique identifier for an audio bible
Request
curl https://arc.dbs.org/api/bible-audio/{id}
const res = await fetch('https://arc.dbs.org/api/bible-audio/{id}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/bible-audio/{id}').json()
Responses
200 Detailed information about the specific audio bible
404 Audio bible not found

bible-books-chapterized

GET /api/bible-books-chapterized/{iso}

Retrieves chapterized books by ISO639-3

Parameters
Name In Type Required Description
iso path yes
Request
curl https://arc.dbs.org/api/bible-books-chapterized/{iso}
const res = await fetch('https://arc.dbs.org/api/bible-books-chapterized/{iso}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/bible-books-chapterized/{iso}').json()
Responses
200 Chapterized list of bible books for the specified language
404 Language not found

bible-books

GET /api/bible-books/{iso}

Retrieves bible books by ISO language code

Parameters
Name In Type Required Description
iso path yes
Request
curl https://arc.dbs.org/api/bible-books/{iso}
const res = await fetch('https://arc.dbs.org/api/bible-books/{iso}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/bible-books/{iso}').json()
Responses
200 List of bible books for the specified language
404 Language not found

bible-text

GET /api/bible-text/

Retrieves bible text index

Request
curl https://arc.dbs.org/api/bible-text/
const res = await fetch('https://arc.dbs.org/api/bible-text/');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/bible-text/').json()
Responses
200 Bible text index
GET /api/bible-text/{bibleId}/{bookId}/{chapter}

Get Bible text for the Bible, book, and chapter

Parameters
Name In Type Required Description
bibleId path string yes The unique identifier of the bible
bookId path string yes The unique identifier of the book within the bible
chapter path integer yes The chapter number within the book
Request
curl https://arc.dbs.org/api/bible-text/{bibleId}/{bookId}/{chapter}
const res = await fetch('https://arc.dbs.org/api/bible-text/{bibleId}/{bookId}/{chapter}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/bible-text/{bibleId}/{bookId}/{chapter}').json()
Responses
200 Detailed bible text for the specified book and chapter
404 Text not found for the specified book and chapter

bibles

GET /api/bibles

Retrieves a list of bibles

Parameters
Name In Type Required Description
country_id query no Filter bibles by country ID
iso query no Filter bibles by ISO code
organization_id query string no Filter bibles by organization ID
require_source query boolean no Whether a source is required
id_string query string no Filter bibles by ID string
Request
curl https://arc.dbs.org/api/bibles
const res = await fetch('https://arc.dbs.org/api/bibles');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/bibles').json()
Responses
200
GET /api/bibles/{id}

Retrieves a bible by ID

Parameters
Name In Type Required Description
id path string yes The unique identifier for a bible
Request
curl https://arc.dbs.org/api/bibles/{id}
const res = await fetch('https://arc.dbs.org/api/bibles/{id}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/bibles/{id}').json()
Responses
200 Detailed information about a bible
404 Bible not found
GET /api/bibles/{id}/books

Retrieves books of a specific bible by bible ID

Parameters
Name In Type Required Description
id path string yes The unique identifier for the bible whose books are being retrieved
Request
curl https://arc.dbs.org/api/bibles/{id}/books
const res = await fetch('https://arc.dbs.org/api/bibles/{id}/books');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/bibles/{id}/books').json()
Responses
200 List of books in the specified bible
404 Bible not found

books

GET /api/books

Retrieves a list of books

Request
curl https://arc.dbs.org/api/books
const res = await fetch('https://arc.dbs.org/api/books');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/books').json()
Responses
200

countries

GET /api/countries

Retrieves a list of countries

Request
curl https://arc.dbs.org/api/countries
const res = await fetch('https://arc.dbs.org/api/countries');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/countries').json()
Responses
200
GET /api/countries/{id}

Retrieves a country by ID

Parameters
Name In Type Required Description
id path string yes The unique identifier for a country
Request
curl https://arc.dbs.org/api/countries/{id}
const res = await fetch('https://arc.dbs.org/api/countries/{id}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/countries/{id}').json()
Responses
200 Detailed information about a country
404 Country not found

films

GET /api/films

Retrieves a list of films

Parameters
Name In Type Required Description
iso query no
book_id query string no Filter films by book ID.
organization_id query string no Filter films by the organization that produced them.
Request
curl https://arc.dbs.org/api/films
const res = await fetch('https://arc.dbs.org/api/films');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/films').json()
Responses
200
GET /api/films/{id}

Retrieves detailed information about a specific film by ID

Parameters
Name In Type Required Description
id path string yes The unique identifier for the film
Request
curl https://arc.dbs.org/api/films/{id}
const res = await fetch('https://arc.dbs.org/api/films/{id}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/films/{id}').json()
Responses
200 Detailed information about the specific film
404 Film not found

languages

GET /api/languages

Retrieves a list of languages

Request
curl https://arc.dbs.org/api/languages
const res = await fetch('https://arc.dbs.org/api/languages');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/languages').json()
Responses
200
GET /api/languages/{iso}

Retrieves a language by The iso code

Parameters
Name In Type Required Description
iso path yes The unique identifier for a language
Request
curl https://arc.dbs.org/api/languages/{iso}
const res = await fetch('https://arc.dbs.org/api/languages/{iso}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/languages/{iso}').json()
Responses
200 Detailed information about a language
404 Language not found

libraries

GET /api/libraries

Retrieves a list of libraries

Request
curl https://arc.dbs.org/api/libraries
const res = await fetch('https://arc.dbs.org/api/libraries');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/libraries').json()
Responses
200
GET /api/libraries/{id}

Retrieves details about a specific library by ID

Parameters
Name In Type Required Description
id path string yes The unique identifier for the library
Request
curl https://arc.dbs.org/api/libraries/{id}
const res = await fetch('https://arc.dbs.org/api/libraries/{id}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/libraries/{id}').json()
Responses
200 Detailed information about the specific library
404 Library not found

numerals

GET /api/numerals

Retrieves numerals in various scripts and variations

Parameters
Name In Type Required Description
digits query integer yes The digits to be converted
script query string yes The script code used for numeral conversion
variation query string no Optional variation within the numeral system
script enum: Latn Armn Arab Copt Thai Sinh Hans Hant Deva Viet Gujr Knda Mlym Orya Grek Guru Taml Telu Tibt Mymr Hebr Jpan
variation enum: Roman urdu epact
Request
curl https://arc.dbs.org/api/numerals
const res = await fetch('https://arc.dbs.org/api/numerals');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/numerals').json()
Responses
200 A list of numeral systems

organizations

GET /api/organizations

Retrieves a list of organizations

Request
curl https://arc.dbs.org/api/organizations
const res = await fetch('https://arc.dbs.org/api/organizations');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/organizations').json()
Responses
200 List of organizations
GET /api/organizations/{id}

Retrieves an organization by ID

Parameters
Name In Type Required Description
id path string yes The unique identifier for an organization
Request
curl https://arc.dbs.org/api/organizations/{id}
const res = await fetch('https://arc.dbs.org/api/organizations/{id}');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/organizations/{id}').json()
Responses
200 Detailed information about an organization
404 Organization not found

stats

GET /api/stats

Retrieves statistics

Request
curl https://arc.dbs.org/api/stats
const res = await fetch('https://arc.dbs.org/api/stats');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/stats').json()
Responses
200 Statistics data

systems

GET /api/systems/

Retrieves health status of the system

Request
curl https://arc.dbs.org/api/systems/
const res = await fetch('https://arc.dbs.org/api/systems/');
const data = await res.json();
import requests
data = requests.get('https://arc.dbs.org/api/systems/').json()
Responses
200 Current health status of the system

Schemas

schema Alphabet
Field Type Description
baseline string Describes the baseline alignment of the script.
case boolean Indicates if the alphabet has distinct upper and lower cases.
complex_positioning string Notes on complex contextual positioning in the alphabet.
contextual_forms boolean Specifies if the alphabet uses contextual forms.
description string Detailed description of the alphabet.
diacritics boolean Specifies if the alphabet uses diacritics.
direction string The general direction in which the script is written (e.g., LTR, RTL).
direction_notes string Additional notes on the directionality of the script.
family string The family classification of the alphabet.
ligatures string Information on any ligatures used in the alphabet.
name string The name of the alphabet.
open_type_tag string OpenType tag associated with the alphabet.
reordering boolean Indicates if the alphabet involves reordering of characters.
requires_font boolean Indicates whether a specific font is required to render the alphabet properly.
sample string A text sample of the alphabet.
sample_img string URL to an image file showing a sample of the alphabet.
script
split_graphs boolean Specifies if the alphabet uses split graphs.
status string Current status of the alphabet (e.g., active, obsolete).
type string The type or category of the alphabet.
unicode boolean Indicates whether the alphabet is fully supported by Unicode.
unicode_pdf string URL to a PDF document describing the Unicode implementation of the alphabet.
whitespace string Describes how whitespace is handled in the alphabet.
schema AlphabetNumeralSystem
Field Type Description
createdAt string The date and time the alphabet numeral system was created.
numeralSystemID string The ID of the numeral system, referencing NumeralSystem.
scriptID string The ID of the script used, possibly referencing another entity.
updatedAt string The date and time the alphabet numeral system was last updated.
schema Artwork
Field Type Description
author
author_id string The identifier of the author who created the artwork.
date integer The year the artwork was created.
filename string The filename of the artwork's digital representation.
id string The unique identifier for the artwork.
keywords string Keywords associated with the artwork for search enhancement.
location string The location where the artwork is displayed or stored.
medium string The medium used to create the artwork.
reference string Reference information for the artwork.
title string The title of the artwork.
type string The type of artwork (e.g., painting, sculpture).
schema Author
Field Type Description
born string The date of birth of the author.
description string A brief description of the author.
died string The date of death of the author, if applicable.
id string The unique identifier for the author.
name string The name of the author.
schema Bible
Field Type Description
abbr
bible_equivalents array
bible_links array
bible_organizations array
bible_pod array
copyright string Copyright notice of the bible.
copyright_type string Type of copyright held.
country
country_id
description string Detailed description of the bible.
description_short string Short description of the bible.
description_vernacular string Vernacular description of the bible.
iso
language
parent_bible_id ID of the parent bible, if any.
questionable boolean Flag indicating if the content is questionable.
script
title string The main title of the bible.
title_vernacular string Vernacular title of the bible.
year integer Publication year of the bible.
schema BibleEquivalent
Field Type Description
bible_abbr Abbreviation of the bible related to this equivalent.
equivalent_id string Unique identifier for the equivalent.
id string Unique identifier of the BibleEquivalent record.
notes string Additional notes about the equivalent.
organization_id string Identifier for the organization associated with this equivalent.
site string The website associated with the equivalent.
suffix string Suffix information for the equivalent.
type string Type of equivalent (e.g., translation, paraphrase).
url string URL related to the equivalent.
schema BibleOrganization
Field Type Description
bible_abbr Abbreviation of the bible related to this organization.
id string Unique identifier of the BibleOrganization record.
organization_id string Identifier for the organization linked with the bible.
relationship_type string Type of relationship the organization has with the bible (e.g., publisher, translator).
schema BiblePod
Field Type Description
bible_abbr Abbreviation of the bible related to this pod.
columns integer Number of text columns in the pod.
counter_style string Counter style used for numbering in the pod.
cover_filter string Filter used for the cover of the pod.
custom_styles string Custom styles applied to the pod.
description string Description of the pod's contents or purpose.
font string Primary font used in the pod.
font_bold string Bold font used in the pod.
font_format string Font format used in the pod.
font_size number Font size used in the pod.
id string Unique identifier of the BiblePod record.
justified boolean Indicates if the text is fully justified.
justified_cjk boolean Indicates if CJK text is fully justified.
line_height number Line height used in the pod.
orphans integer Orphan control setting for the pod.
pages integer Number of pages in the pod if applicable.
partner_id string Identifier for the partner associated with this pod.
portion boolean Indicates if the pod covers a portion of the bible.
print_banned boolean Indicates if the pod is banned from printing.
print_ready boolean Indicates if the pod is ready for printing.
publisher_id string Identifier for the publisher associated with this pod.
scope string Scope of the pod content (e.g., bible, new testament).
trim string Trim size or dimensions of the pod product.
widows integer Widow control setting for the pod.
schema Country
Field Type Description
FIPS string FIPS 10-4 code for the country.
autonym string The name of the country in its official language.
continent_id string Identifier for the continent where the country is located.
country_persecution array
country_regions array
country_translations array
hidden boolean Flag to indicate if the country should be hidden in listings.
id
independent boolean Indicates whether the country is recognized as independent.
introduction string Brief introduction about the country.
iso_a3 string ISO 3166-1 alpha-3, three-letter country code.
iso_num integer ISO 3166-1 numeric three-digit country code.
landmass_km integer Total landmass of the country in square kilometers.
languages array
name string The official name of the country.
name_long string The full formal name of the country.
official_language string The official language of the country.
official_language_iso string ISO code for the official language of the country.
overview string Detailed overview of the country.
population integer Total population of the country.
region_code integer Numeric code representing a specific region within the country.
region_id string Unique identifier for a region within the country.
region_name string Name of a specific region within the country.
religion_primary string Primary religion of the country.
url_wiki string Wikipedia URL for the country.
schema CountryPersecution
Field Type Description
country_id
id integer Unique identifier for the persecution record.
persecution_type string Type of persecution reported.
rank integer Rank of the country based on the level of persecution.
score integer Persecution score.
url string URL for more information about the persecution.
year integer Year of the reported persecution.
schema CountryRegion
Field Type Description
country_coordinates string Coordinates of the country's region.
country_id
m49_code integer UN M49 standard region code.
region_blue integer Blue RGB component of the region's color.
region_code integer Code identifying the region within the country.
region_green integer Green RGB component of the region's color.
region_hex string Hexadecimal color code for the region.
region_name string Name of the region within the country.
region_red integer Red RGB component of the region's color.
sub_region_code integer Code identifying the sub-region within the country.
sub_region_name string Name of the sub-region within the country.
schema CountryTranslation
Field Type Description
country_id
id integer Unique identifier for the country translation.
iso string ISO language code for the translation.
name string Translated name of the country.
schema Film
Field Type Description
book_id string Book ID related to the film, if applicable.
chapter_end integer The ending chapter number for the film's content.
chapter_start integer The starting chapter number for the film's content.
description string A text description of the film.
duration_ms integer Duration of the film in milliseconds.
filename string The filename of the film.
image string Main image for the film.
img_poster string Poster image for the film.
img_thumb string Thumbnail image for the film.
iso
organization_id string ID of the organization that produced the film.
slug string Unique slug identifier for the film.
subtitle string The subtitle of the film.
title string The title of the film.
title_vernacular string The vernacular title of the film.
url string URL to access the film.
youtube_playlist string YouTube playlist URL containing the film.
youtube_url string URL to the YouTube page for the film.
schema GenericList

No properties defined.

schema Language
Field Type Description
area string Specific area where the language is primarily used.
autonym string The name of the language in the language itself.
country_id
description string Brief description of the language.
development string Development status of the language.
glotto_family string Glotto family classification of the language.
glotto_id string GlottoID for the language, if applicable.
iso
iso1 string ISO 639-1 code, a two-character language identifier.
latitude number Geographic latitude of the primary region where the language is spoken.
level string The societal level of the language's use.
location string Geographical locations where the language is spoken.
longitude number Geographic longitude of the primary region where the language is spoken.
macroarea string Geographic macroarea where the language is spoken.
name string The common name of the language.
population integer Estimated number of speakers of the language.
status_id string Status identifier of the language.
use string Current use status of the language.
writing string Writing systems used for the language.
schema NumeralSystem
Field Type Description
description string A detailed description of the numeral system.
id string The primary key for the numeral system.
name string The name of the numeral system.
nameAlternative string An alternative name for the numeral system.
notes string Additional notes about the numeral system.
schema Organization
Field Type Description
abbreviation string Abbreviation for the organization
address string Address of the organization
autonym string The autonym of the organization
bible_count integer Number of Bibles associated with the organization
color_primary string Primary color of the organization in hexadecimal
color_secondary string Secondary color of the organization in hexadecimal
country_id string 2-letter country code (ISO 3166-1 alpha-2)
country_name string Full name of the country
email string Email address of the organization
film_count integer Number of films associated with the organization
icon string URL to the organization's icon
id string Unique identifier for the organization
inactive boolean Whether the organization is inactive
latitude number Latitude of the organization
logo string URL to the organization's logo
longitude number Longitude of the organization
name string The name of the organization
notes string Additional notes about the organization
phone string Phone number of the organization
resource_count integer Number of resources associated with the organization
slug string Unique slug for the organization
type string Type of organization
url string URL of the organization
zip string ZIP or postal code
schema bible_id

No properties defined.

schema country_id

No properties defined.

schema iso

No properties defined.

schema script

No properties defined.