Search

The search endpoint allows you to perform full-text keyword searches across all scripture verses. Results are returned as a paginated list of matching verses with their scripture reference, book, chapter, verse number, and the full verse text.

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.

Search results model

Each item in the results array represents a single matching verse.

Properties

Name
query
Type
string
Description
The search term that was used for this request
Name
total
Type
integer
Description
The total number of verses that match the query (across all pages)
Name
limit
Type
integer
Description
The maximum number of results returned in this response
Name
offset
Type
integer
Description
The number of results skipped before this page of results
Name
results
Type
array
Description
An array of matching verse objects
Name
results[].reference
Type
string
Description
The human-readable scripture reference, e.g. Alma 32:21
Name
results[].book
Type
string
Description
The title of the book containing this verse
Name
results[].chapter
Type
integer
Description
The chapter number containing this verse
Name
results[].verse
Type
integer
Description
The verse number within its chapter
Name
results[].text
Type
string
Description
The full plaintext of the matching verse

GET/search

Search scripture text

This endpoint searches all scripture verses for the given query string and returns a paginated list of matching verses.

Required query parameters

Name
q
Type
string
Description
The search term or phrase to look for in verse text

Optional query parameters

Name
limit
Type
integer
Description
The maximum number of results to return. Default is 20, maximum is 100.
Name
offset
Type
integer
Description
The number of results to skip for pagination. Default is 0.
Name
volume
Type
string
Description
Filter results to a specific volume by its id. For example, bookofmormon, oldtestament, newtestament, doctrineandcovenants, or pearlofgreatprice.

cURL

curl "https://openscriptureapi.org/api/scriptures/v1/lds/en/search?q=faith&limit=3&offset=0"

Response

{
  "query": "faith",
  "total": 336,
  "limit": 3,
  "offset": 0,
  "results": [
    {
      "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."
    },
    {
      "reference": "Ether 12:6",
      "book": "Ether",
      "chapter": 12,
      "verse": 6,
      "text": "And now, I, Moroni, would speak somewhat concerning these things; I would show unto the world that faith is things which are hoped for and not seen; wherefore, dispute not because ye see not, for ye receive no witness until after the trial of your faith."
    },
    {
      "reference": "Hebrews 11:1",
      "book": "Hebrews",
      "chapter": 11,
      "verse": 1,
      "text": "Now faith is the substance of things hoped for, the evidence of things not seen."
    }
  ]
}

Note: the Open Scripture API is still in beta, and these resources/endpoints can change at any time