Scripture · API docs

Folio carries the King James Version only. Any other translation code is not found. Verse text in notes, outputs and answers is checked against it before it can be published.

curl -X GET "$FOLIO_API_URL/v1/scripture/lookup?ref=Romans%208:28" \
  -H "Authorization: Bearer $FOLIO_API_KEY"

Response

{
  "status": true,
  "message": "passage",
  "data": {
    "object": "passage",
    "ref": "Romans 8:28",
    "book": "Romans",
    "chapter": 8,
    "verse_start": 28,
    "verse_end": 28,
    "translation": "KJV",
    "verses": [{ "n": 28, "text": "And we know that all things work together for good to them that love God, to them who are the called according to his purpose.", "teachings": 4 }],
    "taught": { "times": 4, "preachers": 2, "years": 3 }
  }
}

ref accepts a verse (John 3:16), a range (Romans 8:28-30) or a whole chapter (Psalm 23). Besides the text, the response says how many times the church has taught the passage, by how many preachers over how many years, and lists the teachings that quote it with a time-coded excerpt.

List the installed translations with GET /v1/scripture/translations; today it holds the King James Version with its edition, licence and attribution. Show the attribution where you display the text.

Public pages#

A church's published verse pages are readable without a key at GET /v1/public/{church}/verses/{slug}.

Booth#

Booths download the King James Version as a text pack for offline use; see booth devices.

Verified against API version 0.0.0-dev. Generated from the live OpenAPI document.