API

Returns a single verse with its footnotes and cross-references.

Parameters

Name	In	Description
book	path	Book slug (see Book slugs)
chapter	path	Chapter number
verse	path	Verse number

Example request

GET /api/verse/john/3/16

Example response

{
  "book": "john",
  "book_title": "The Gospel of Jesus Christ According to S. John",
  "chapter": 3,
  "verse": 16,
  "text": "For God so loved the world, as to give his only-begotten Son: that whosoever believeth in him may not perish, but may have life everlasting.",
  "notes": [
    {
      "label": "a",
      "text": "The love of God to man was so great, that he gave his only Son to die for man's salvation."
    }
  ],
  "cross_refs": [
    { "text": "1. Io. 4, 9." }
  ]
}

Returns all verses in a chapter.

Parameters

Name	In	Description
book	path	Book slug
chapter	path	Chapter number

Example request

GET /api/chapter/genesis/1

Example response

{
  "book": "genesis",
  "book_title": "The Book of Genesis",
  "chapter": 1,
  "verse_count": 31,
  "verses": [
    {
      "verse": 1,
      "text": "In the beginning God created heaven and earth.",
      "notes": [],
      "cross_refs": [{ "text": "Act. 14, 15. 17, 24." }]
    },
    ...
  ]
}

Returns the complete book: all chapters, all verses, footnotes, cross-references, chapter introductions, and book metadata. Served as a static file directly from Cloudflare CDN — fastest option when you need a whole book.

Example request

GET /data/odr/matthew.json

Returns a randomly selected verse. Useful for widgets, bots, and daily verse features.

Parameters

Name	In	Description
testament	query	Optional. OT or NT to restrict to one Testament.

Example requests

GET /api/random
GET /api/random?testament=NT

Response shape

Same as /api/verse/:book/:chapter/:verse.

Full-text search across verse text or the full notes corpus (annotations, marginal notes, reference documents).

Parameters

Name	In	Required	Description
q	query	Yes	Search query
scope	query	No	verses (default) or notes
limit	query	No	Max results, 1–500. Default: 100.
counts	query	No	Set to 1 to return only result counts for both scopes, without hydrating results.

Example request

GET /api/search?q=propitiation&scope=verses&limit=20

Verse scope response

{
  "scope": "verses",
  "total": 4,
  "queryTokens": ["propitiation"],
  "results": [
    {
      "heading": "Romans 3",
      "slug": "romans",
      "chapter": 3,
      "bookName": "Romans",
      "verseNumbers": [25],
      "verses": [
        {
          "verse": 25,
          "text": "Whom God hath proposed to be a propitiation, through faith in his blood..."
        }
      ],
      "queryTokens": ["propitiation"]
    }
  ]
}

Notes scope response

{
  "scope": "notes",
  "total": 12,
  "queryTokens": ["propitiation"],
  "results": [
    {
      "reference": "Romans 3:25",
      "slug": "romans",
      "chapter": 3,
      "verse": 25,
      "type": "annotation",
      "title": "Propitiation",
      "noteText": "Christ is our propitiation...",
      "queryTokens": ["propitiation"]
    }
  ]
}