Veritas — Scripture & Theology
The Veritas engine is the intellectual core of the Torch. It exposes four resources: the Bible (/bible), traditional commentaries (/commentaries), the Summa Theologiae (/summa), and the broader corpus of Catholic opera (/opera).
All Veritas endpoints require an X-API-Key header. See Authentication.
Bible — /v1/veritas/bible
Section titled “Bible — /v1/veritas/bible”List Books
Section titled “List Books”GET /v1/veritas/bible/booksReturns all books of the Bible with their slugs and metadata.
Response: List[BibliaLibri]
[ { "id": 1, "slug": "genesis", "nomen_en": "Genesis", "nomen_latin": "Genesis", "testamentum": "OT", "ordo": 1 }]Read a Chapter
Section titled “Read a Chapter”GET /v1/veritas/bible/{book_slug}/{capitulum}Returns all verses in a chapter. Optionally narrow to a verse range.
Path parameters:
book_slug— e.g.,john,romans,genesiscapitulum— chapter number (integer)
Query parameters:
start(optional) — first verse numberend(optional) — last verse number
Response: List[BibliaVersus]
[ { "id": "uuid", "capitulum": 3, "versus_num": 16, "textus_en": "For God so loved the world...", "textus_latin": "Sic enim dilexit Deus mundum...", "exegesis": [] }]Get a Single Verse
Section titled “Get a Single Verse”GET /v1/veritas/bible/{book_slug}/{capitulum}/{versus}Returns a single BibliaVersus object, identical shape to above.
Verse Text (Plain)
Section titled “Verse Text (Plain)”GET /v1/veritas/bible/{book_slug}/{capitulum}/{versus}/textReturns the verse as plain text. Optimized for LLM ingestion and text-to-speech.
Query parameters:
lang—"en"(default) or"la"for Latin
Response: text/plain
Commentaries — /v1/veritas/commentaries
Section titled “Commentaries — /v1/veritas/commentaries”Traditional patristic and scholastic commentary on Scripture.
List Authors
Section titled “List Authors”GET /v1/veritas/commentaries/authorsResponse: List[str] — unique author names in the corpus.
Get Commentaries
Section titled “Get Commentaries”GET /v1/veritas/commentariesQuery parameters:
book_slug(required) — e.g.,johncapitulum(required) — chapter numberversus(optional) — verse numberauctor(optional) — filter by author name
Response: List[BibliaCommentaria]
[ { "id": "uuid", "fons": "Catena Aurea", "auctor": "Thomas Aquinas", "liber_id": 43, "capitulum": 3, "versus_start": 16, "versus_end": 16, "textus": "He says 'the world', that is, all men...", "created_at": "2024-01-01T00:00:00Z" }]Summa Theologiae — /v1/veritas/summa
Section titled “Summa Theologiae — /v1/veritas/summa”The complete Summa Theologiae of St. Thomas Aquinas, structured by Pars → Quaestio → Articulus.
List Partes
Section titled “List Partes”GET /v1/veritas/summa/partesResponse: List[SummaPars] — e.g., Prima Pars, Prima Secundae, Tertia Pars.
Questions for a Pars
Section titled “Questions for a Pars”GET /v1/veritas/summa/partes/{pars_id}/quaestionesResponse: List[SummaQuaestio]
Articles for a Question
Section titled “Articles for a Question”GET /v1/veritas/summa/quaestiones/{quaestio_id}/articuliResponse: List[SummaArticulus] (summary — no body text)
Article Detail
Section titled “Article Detail”GET /v1/veritas/summa/quaestiones/{quaestio_id}/articuli/{numerus}Full article with objections, sed contra, respondeo, and replies.
Response: SummaArticulus
{ "id": 42, "question_id": 2, "number": 3, "title": "Whether God exists?", "slug": "whether-god-exists", "objectiones": [...], "sed_contra": "On the contrary...", "respondeo": "I answer that...", "responsiones": [ { "n": 1, "text": "Reply to objection 1..." } ], "scripture_citations": [...]}SummaScriptureCitation
Section titled “SummaScriptureCitation”The Scripture that St. Thomas cites within an article, hydrated with the text of each verse and the slug needed to read it in context.
| Field | Type | Notes |
|---|---|---|
book_id | int | Internal book ID |
book_slug | str? | Book slug — use with the Bible routes |
book_name | str? | Human-readable book name |
chapter | int | Chapter number |
verse_number | int | Verse number |
text_en | str? | English verse text (Douay–Rheims) |
Read the cited verse in context: GET /v1/veritas/bible/{book_slug}/{chapter}
{ "book_id": 49, "book_slug": "luke", "book_name": "The Gospel According to St. Luke", "chapter": 21, "verse_number": 15, "text_en": "For I will give you a mouth and wisdom, which all your adversaries shall not be able to resist and gainsay."}Opera — /v1/veritas/opera
Section titled “Opera — /v1/veritas/opera”A growing library of Catholic theological and devotional works.
Search the Library
Section titled “Search the Library”GET /v1/veritas/opera/search?q={query}Full-text search across all chapter text. Returns ranked excerpts.
Response: List[CapitulumSearchResult]
List Works
Section titled “List Works”GET /v1/veritas/opera/booksResponse: List[OpusRead]
[ { "id": 1, "title": "The Imitation of Christ", "slug": "imitation-of-christ", "author": "Thomas à Kempis", "collection": null, "language": "en", "copyright_status": "public_domain" }]Get a Work
Section titled “Get a Work”GET /v1/veritas/opera/books/{opus_slug}Response: OpusRead — same shape as above.
Table of Contents
Section titled “Table of Contents”GET /v1/veritas/opera/books/{opus_slug}/tocHierarchical chapter list for navigation.
Response: List[CapitulumTocRead]
[ { "id": 10, "title": "Book I — Admonitions Profitable for the Spiritual Life", "slug": "book-i", "order": 1, "depth": 1, "structure_type": "book", "is_readable": false }, { "id": 11, "title": "Chapter 1 — Of the Imitation of Christ", "slug": "book-i-ch-1", "order": 2, "depth": 2, "structure_type": "chapter", "is_readable": true }]Read a Chapter
Section titled “Read a Chapter”GET /v1/veritas/opera/books/{opus_slug}/{chapter_slug}Response: CapitulumRead — extends CapitulumTocRead with text, prev_slug, and next_slug for sequential navigation.
Chapter Raw Text
Section titled “Chapter Raw Text”GET /v1/veritas/opera/books/{opus_slug}/{chapter_slug}/rawPlain text response. Optimized for LLM context injection.
Response: text/plain