logos77

Fetch a verse, range, or full chapter

Look up one or more verses of scripture. "book" is the book name in the translation's native language (e.g. John, Jean, Johannes). "verse" may be a single number or a range like "16-18"; omit it for the whole chapter.

Deterministic verse of the day

Returns the same verse for everyone on a given day, advancing one verse per day so it never repeats within a reading cycle.

A random verse

Returns a genuinely random verse of scripture.

Search within a translation

Case-insensitive substring search over verse text in a translation. Returns up to "limit" matching verses (1-100, default 20).

Read continuously through a translation

Read scripture in canonical order from "from" to "to". Omit "from" to start at the first verse, and omit "to" to read to the end — a request with only "lang" covers the whole Bible. Alternatively pass "group" (a group tag, label or alias — e.g. "OT_LAW", "Torah", "Pauline Epistles") to read one canonical group instead; group is mutually exclusive with from/from_after/to and only continuous groups are readable this way (see list_groups). The canon is a loop: when from comes after to, reading cont

List the books of a translation

List the 66 books in canonical order for a translation, with their native names and chapter counts. Native book names are the vocabulary accepted by "book" (fetch_passage) and "from"/"to" (read_through), so this is how callers discover the correct referencing.

List the available translations and their script properties

List every translation with its label, subdomain, and script metadata: writing direction (rtl/ltr), maximum UTF-8 bytes per code point, whether the script uses combining marks, and a sample verse for font/decoder verification. Use this to let a client (especially an embedded or small-display device) discover languages and adapt rendering before fetching any text.

List canonical book groupings for reading plans

List the traditional, overlapping book groupings (the Law, History, Wisdom, Major/Minor Prophets, Gospels, Paul's Letters, General Letters, Revelation, cross-cutting groups and traditional subsets) with per-translation native book names, inclusive whole-book index ranges, chapter/verse totals, contiguity, and a resolvable start/end span. Every continuous group has a "tag", "label" and "aliases" accepted by read_through's "group" parameter; non-contiguous groups (contiguous=false) must be read bo