Cross References
Each verse can contain footnotes that reference related scripture passages. The cross-references endpoint extracts those scripture references from a verse's footnote data and returns them in both raw and pretty-printed form.
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 cross-references model
The cross-references response contains the verse text and any scripture cross-references parsed from its footnotes.
Properties
- Name
reference- Type
- string
- Description
A human-readable reference string for the verse, e.g. "Alma 32:21"
- Name
book- Type
- string
- Description
The title of the book containing the 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 of the verse
- Name
crossReferences- Type
- array
- Description
An array of cross-reference objects 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 omitted.
- Name
crossReferences[].raw- Type
- string
- Description
The raw footnote reference text as stored in the database, e.g. "Heb. 11:1 (1–40)"
- Name
crossReferences[].prettyString- Type
- string
- Description
A normalized, pretty-printed version of the reference, e.g. "Hebrews 11:1-40"
Get cross-references for a verse
This endpoint returns a single verse along with its cross-references derived from footnote data.
Required path parameters
- Name
book_id- Type
- string
- Description
The id of the book, e.g. "alma", "1nephi", "doctrineandcovenants"
- Name
chapter_number- Type
- integer
- Description
The chapter number within the book (1-indexed)
- Name
verse_number- Type
- integer
- Description
The verse number within the chapter (1-indexed)
cURL
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": [
{
"raw": "John 20:29; Heb. 11:1 (1–40).",
"prettyString": "John 20:29; Hebrews 11:1-40"
},
{
"raw": "Ether 12:6.",
"prettyString": "Ether 12:6"
}
]
}