Verses
Fetch a single verse by its book, chapter, and verse number. The verse endpoint also returns any scripture cross-references parsed from the verse's footnotes.
Note: For all API url examples the url given is appended to the base url. The base url will include information like the desired
API version, denomination, and language of the resource that you are requesting. If you simply append the endpoint to "openscriptureapi.org" you
will get a 404 error.
The verse model
Properties
- Name
reference- Type
- string
- Description
The human-readable reference string for this verse, e.g.
"Alma 32:21"
- Name
book- Type
- string
- Description
The title of the book containing this verse
- Name
chapter- Type
- integer
- Description
The chapter number
- Name
verse- Type
- integer
- Description
The verse number (1-indexed)
- Name
text- Type
- string
- Description
The plain text content of the verse
- Name
crossReferences- Type
- array
- Description
Scripture references parsed from the verse's footnotes. Only footnotes that resolve to valid scripture references are included — topical guide entries and other non-scripture footnotes are filtered out.
- Name
crossReferences[].raw- Type
- string
- Description
The raw footnote text, e.g.
"Gen. 22:2 (1–14)"
- Name
crossReferences[].prettyString- Type
- string
- Description
The normalized reference string, e.g.
"Genesis 22:2"
Get a verse
Returns a single verse and its cross-references.
Required path parameters
- Name
book_id- Type
- string
- Description
The ID of the book (e.g.
alma,john,doctrineandcovenants)
- Name
chapter_number- Type
- integer
- Description
The chapter number, 1-indexed
- Name
verse_number- Type
- integer
- Description
The verse number, 1-indexed. Returns
404if out of range.
Request
curl https://openscriptureapi.org/api/scriptures/v1/lds/en/book/alma/32/21
Response
{
"reference": "Alma 32:21",
"book": "Alma",
"chapter": 32,
"verse": 21,
"text": "And now as I said concerning faith—faith is not to have a perfect knowledge of things; therefore if ye have faith ye hope for things which are not seen, which are true.",
"crossReferences": []
}
Response with cross-references
{
"reference": "John 3:16",
"book": "John",
"chapter": 3,
"verse": 16,
"text": "For God so loved the world, that he gave his only begotten Son, that whosoever believeth in him should not perish, but have everlasting life.",
"crossReferences": [
{
"raw": "D&C 45:5",
"prettyString": "D&C 45:5"
}
]
}