YouVersion PlatformYouVersion Platform
PlatformContent LibraryDev 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
  • Core Beliefs

© 2026 YouVersion. All rights reserved.

  • Overview
  • API Reference
  • SDKs
  • Changelog
<  Back to Platform
Getting Started
    YouVersion Platform OverviewAPI Usage
Guides
    Display Bible HTMLLanguage rangesSign-in APIsSearch APIsVerse ImagesUSFM ReferenceError Codes
Useful Links
    YouVersionGitHub
Getting Started

API Usage

YouVersion Platform provides SDKs for several popular coding languages, as well as the REST API which gives you direct access to the same services which power the SDKs. Use it when you need a fully custom integration, to automate content workflows, or to support platforms where an SDK is not yet available.

Before You Start

Create your developer account and register your application at platform.YouVersion.com. Accept the license agreements for the Bible versions you want to use.

App Keys

Copy the App Key from your app in the Platform Portal. Replace YOUR_APP_KEY_HERE with that value and export it in your terminal:

TerminalCode
export YVP_APP_KEY='YOUR_APP_KEY_HERE'

Send the key in the X-YVP-App-Key header for the content API requests in this guide:

Code
X-YVP-App-Key: YOUR_APP_KEY_HERE

For user sign-in, follow Sign-in APIs. For a missing or invalid App Key, see Authentication Errors.

Base URL

The production content API base URL is https://api.youversion.com/v1.

Make Your First Request

Fetch the text of John 3:16 from the BSB using cURL:

TerminalCode
curl -H "x-yvp-app-key: $YVP_APP_KEY" "https://api.youversion.com/v1/bibles/3034/passages/JHN.3.16"

Or perform that same request with Python:

Code
import os import requests def get_verse(): app_key = os.environ.get("YVP_APP_KEY") headers = {"X-YVP-App-Key": app_key} url = "https://api.youversion.com/v1/bibles/3034/passages/JHN.3.16" response = requests.get(url, headers=headers) response.raise_for_status() return response.json() print(get_verse())

Core Bible API Concepts

To get the Bible text for a given verse, passage or chapter, use the passages API as seen above.

Browse every endpoint and its response format in the interactive API reference. Bible collections return their items in data. A request for one Bible returns the Bible object directly.

If you are placing passage HTML on a web page, follow Display Bible HTML to add Bible CSS, the Fonts API stylesheet, and the required Bible version attribution. It includes both a direct REST example and a simpler JavaScript SDK path.

List Available Bible Versions

Use language_ranges[] to select languages. Repeat the parameter to supply more than one preference; see Language ranges.

TerminalCode
curl --get -H "X-YVP-App-Key: $YVP_APP_KEY" \ --data-urlencode 'language_ranges[]=en' \ "https://api.youversion.com/v1/bibles"

Get Bible and Book Metadata

Get the BSB's metadata:

TerminalCode
curl -H "X-YVP-App-Key: $YVP_APP_KEY" \ "https://api.youversion.com/v1/bibles/3034"

List its books:

TerminalCode
curl -H "X-YVP-App-Key: $YVP_APP_KEY" \ "https://api.youversion.com/v1/bibles/3034/books"

List verse metadata for John chapter 3:

TerminalCode
curl -H "X-YVP-App-Key: $YVP_APP_KEY" \ "https://api.youversion.com/v1/bibles/3034/books/JHN/chapters/3/verses"

Passage IDs

The passages API takes a passage_id in USFM format. It accepts four forms:

FormExampleReturns
Single verseJHN.3.16John 3:16
Verse range within one chapterJHN.3.16-18John 3:16-18
Whole chapterJHN.3John chapter 3
Book introductionGEN.INTROThe introduction to Genesis

A range cannot cross a chapter boundary. A request for JHN.14.31-15.2 returns 404 Not Found with a message such as Bible passage JHN.14.31-15.2 for version 3034 not found.

To fetch a passage that spans chapters, request each chapter's verses separately and join the text in your app:

TerminalCode
curl -H "x-yvp-app-key: $YVP_APP_KEY" "https://api.youversion.com/v1/bibles/3034/passages/JHN.14.31" curl -H "x-yvp-app-key: $YVP_APP_KEY" "https://api.youversion.com/v1/bibles/3034/passages/JHN.15.1-2"

Book identifiers such as JHN are listed in the USFM reference.

Pagination

Some endpoints support pagination using the page_size and page_token parameters. You can request up to 99 items per page. When more results are available, the response includes a next_page_token; send that back as page_token in your next request to fetch the following page.

Handle Errors and Rate Limits

Check the HTTP status before parsing a response body. The Error Codes guide covers response formats, App Key failures, and rate limits and retry handling.

For an SDK integration, start with the SDK overview.

Need Help?

If you need help integrating with our API or have questions about the documentation, please reach out to our support team.

Last modified on November 17, 2026
YouVersion Platform OverviewDisplay Bible HTML
On this page
  • Before You Start
    • App Keys
  • Base URL
  • Make Your First Request
  • Core Bible API Concepts
    • List Available Bible Versions
    • Get Bible and Book Metadata
    • Passage IDs
    • Pagination
  • Handle Errors and Rate Limits
  • Need Help?