YouVersion PlatformYouVersion Platform
PlatformBiblesDev Docs
CommunityPartnersSupport

YouVersion Platform

Build applications and integrate with the world's most popular Bible platform.

Platform Products

  • Platform Portal
  • Developer Documentation
  • App Management

Resources

  • Support
  • Press inquiries

Legal

  • Privacy Policy
  • Terms of Use

© 2026 YouVersion. All rights reserved.

  • Overview
  • API Reference
  • SDKs
  • Changelog
<  Back to Platform
data exchange
    Show the data exchange approval page.getComplete the data exchange approval flow.postCreate a data exchange token.post
bibles
    Get a Bible collectiongetGet a Bible's datagetGet the index for a BiblegetGet a passage of Bible textgetGet a Book collection for a BiblegetGet a Book's datagetGet a Chapter collection for a BookgetGet a Chapter's datagetGet a Verse collection for a ChaptergetGet a Verse's dataget
fonts
    Get a collection of fonts supported in the Platform.getGet details about a specific font family in the Platform.getGet a browser-consumable stylesheet for a specific font family.get
highlights
    Get a collection of highlights for a user.getCreate or update a highlight on a passage.postClear highlights for a passage.delete
languages
    Get a collection of languages supported in the Platform.getGet details about a specific language in the Platform.get
licenses
    Get a collection of licensesget
permissions
    Get permissions granted to an app.get
organizations
    Get a collection of organizations in the Platform.getGet details about a specific organization in the Platform.getGet bibles associated with a specific organization in the Platform.get
verse of the days
    Get the verse of the day calendar for an entire year.getGet the verse of the day for a specific day of the year.get
search_queries
    Get suggested or trending search queries.get
search_unified
    Search the Platform for Bible verses and related topics.get
search_topics
    Search the Platform for topics related to a query.get
search_verses
    Search the Platform for Bible verses.get
apps
    Get details about a specific app in the Platform.get
Schemas
Transformers
Transformers

search_verses

Endpoint

Search the Platform for Bible verses.

GET
https://api.youversion.com
/v1/search-verses

Search for Bible verses by query, returning a paginated list of verse references. Verse results carry references and metadata only (e.g. JHN.3.16), never passage text; resolve verse text through the licensed-content endpoint. The bible_id determines the language searched, so this endpoint takes no language parameter. Use page_size and page_token to page through the full result set.

Search the Platform for Bible verses. › query Parameters

query
​string · minLength: 1 · maxLength: 100 · required

The search query string used to find matching results.

bible_id
​integer · int32 · required

The Bible version identifier

Example: 3034
user_intent
​string · enum

The searcher's intent. Defaults to unknown, matching the Core Search service.

Enum values:
unknown
topical
text
reference
Default: unknown
page_size
​integer · min: 1 · max: 99

The number of verse results to return in the collection. Must be between 1 and 99.

Example: 25
Default: 25
page_token
​string

The page token to retrieve results from.

Example: eyJzdGFydF9hdCI6IDI2fQ==

Search the Platform for Bible verses. › Responses

Successful request

A paginated list of Bible verse search results. Verse results carry references and metadata only (e.g. JHN.3.16), never passage text; resolve verse text through the licensed-content endpoint.
​object[] · readOnly · required
user_intent
​string | null · required

The intent the Core Search service resolved for the query.

Example: text
did_you_mean
​string[] · required

Alternative spellings the search service suggests for the query.

Example: ["water","war"]
search_instead_for
​string | null · required

A corrected query the results were actually returned for, if any.

next_page_token
​string | null · readOnly

Token to send to the server when retrieving the next page of results.

Example: eyJzdGFydF9hdCI6IDI2fQ==
GET/v1/search-verses
curl --request GET \ --url 'https://api.youversion.com/v1/search-verses?query=%3Cstring%3E&bible_id=%3Cnumber%3E'
shell
Example Responses
{ "verses": [ { "reference": "JHN.3.16" } ], "user_intent": "text", "did_you_mean": [ "water", "war" ], "search_instead_for": "search_instead_for", "next_page_token": "eyJzdGFydF9hdCI6IDI2fQ==" }
json
application/json

search_topicsapps