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
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
data exchange
    Show the data exchange approval page.getComplete the data exchange approval flow.postCreate a data exchange token.post
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 licensesgetGet the partner supplied licenses of a developerget
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.getGet video playlists associated with a specific organization in the Platform.getGet an organization video playlist by id.get
permissions
    Get permissions granted to an app.get
search
    Get suggested or trending search queries.getSearch the Platform for videos.getSearch the Platform for Bible verses, topics, images, and videos.getSearch the Platform for topics related to a query.getSearch the Platform for Bible verses.getSearch the Platform for verse images.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
videos
    Get a collection of videos.getGet a video resource by id.get
apps
    Get details about a specific app in the Platform.get
images
    List verse-art images, optionally filtered by language and/or verse.getResolve a verse-art image id to its full metadata.get
Schemas
Transformers
Transformers

videos

Endpoint

Provides videos that the calling app has a license for.


Get a collection of videos.

GET
https://api.youversion.com
/v1/videos

Returns the videos that the calling app has a license for, in the requested Accept-Language preferences, including parent language tags. An omitted header defaults to English. Explicit preferences do not fall back to English unless they include English. Each video is in the same shape as the video resource, and the response lists each video one time.

total_size is an upper bound on the number of videos across all pages. The response omits a video that is not available in the requested language, and total_size still counts it. So a page can hold fewer videos than page_size. Keep paging while next_page_token is present.

Send next_page_token back with the same Accept-Language as the request that produced it. A different value gives a 400. You can change page_size between pages.

The API returns 204 when the app has no license for any video. It does the same when no video matches the requested languages, and when the page is past the last page. Responses are private to the calling app.

Get a collection of videos. › query Parameters

page_size
​integer · min: 1 · max: 99

The number of items to return in the collection. Must be between 1 and 99. Use the next_page_token from the response as page_token to retrieve the following page. Unlike page_size, this parameter has no unbounded * mode — collections using it are always paged.

Example: 25
Default: 25
page_token
​string

The page token to retrieve results from.

Example: eyJzdGFydF9hdCI6IDI2fQ==

Get a collection of videos. › Headers

Accept-Language
​string

The localization preferred as a response to the request. See RFC 2616 section 14.4 for further details.

Example: en
Default: en

Get a collection of videos. › Responses

Successful request

A paginated list of videos.
​object[] · readOnly · required
total_size
​integer · int32 · readOnly · required

An upper bound on the number of videos in the collection, across all pages. It counts a video that a page omits.

Example: 215
next_page_token
​string | null · readOnly

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

Example: eyJzdGFydF9hdCI6IDI2fQ==
GET/v1/videos
curl --request GET \ --url https://api.youversion.com/v1/videos
shell
Example Responses
{ "data": [ { "id": "eyJhbGciOiJFUzI1NiIsImtpZCI6ImV4YW1wbGUiLCJub25jZSI6ImFjYzc4ZWJjYmMzOWNjNzhlMWYxYjgxZiJ9.WTZESyfRI8PFoaMpnNOXtFPbBAiLLJNq8BHazhdBXQc-EMPbpohn5BKzE693VCvBhMaZDgkwg6_lM2nXMiUoXpYWxWRTnm76647Rn8u_WSss3QbFCgPOlmeCv_UCxk12jB768fG50f0fVEgAhYPjJlvK4r0W4l4k6ZKa5Q9Ff39Z9qBW7CpHrP2IRN4EIdfG7h6hGzxeMZ4iOuE7N1AQQtq0N_KlXQnA2-ZmpiLwdy0MJJC2t-Oq1VkFsKMSUs1rS1fluxLWFHiAWI3k0t7aCVTfSSjwWJAFKONaHJA5JpFy0QEYm78mVcJLK1dFh2ygHXFZ6OPZmiBdTdvlS3qUjEA.SrpbodXlcsFLw_KwGlD7u7T8LYePlhmlYKmqTJcVbL0BbQz_hszqg-PWx9A1rA5AvmTpHlMHaXlA3MyUI-ljeg", "organization_id": "c3187cfe-a191-4088-9fb2-24c306d9eb38", "title": "1 Samuel 17:45", "description": "Teaching clip description.", "passage_ids": [ "1SA.17.45" ], "language_tag": "en", "runtime": 105, "orientation": "portrait", "thumbnail": { "url": "https://cdn.youversion.com/video-images/eyJhbGciOiJFUzI1NiIsImtpZCI6ImV4YW1wbGUiLCJub25jZSI6ImFjYzc4ZWJjYmMzOWNjNzhlMWYxYjgxZiJ9.WTZESyfRI8PFoaMpnNOXtFPbBAiLLJNq8BHazhdBXQc-EMPbpohn5BKzE693VCvBhMaZDgkwg6_lM2nXMiUoXpYWxWRTnm76647Rn8u_WSss3QbFCgPOlmeCv_UCxk12jB768fG50f0fVEgAhYPjJlvK4r0W4l4k6ZKa5Q9Ff39Z9qBW7CpHrP2IRN4EIdfG7h6hGzxeMZ4iOuE7N1AQQtq0N_KlXQnA2-ZmpiLwdy0MJJC2t-Oq1VkFsKMSUs1rS1fluxLWFHiAWI3k0t7aCVTfSSjwWJAFKONaHJA5JpFy0QEYm78mVcJLK1dFh2ygHXFZ6OPZmiBdTdvlS3qUjEA.SrpbodXlcsFLw_KwGlD7u7T8LYePlhmlYKmqTJcVbL0BbQz_hszqg-PWx9A1rA5AvmTpHlMHaXlA3MyUI-ljeg/delivery/images/0bae673f.jpg", "width": 640, "height": 360 }, "playback_sources": [ { "url": "https://video-cdn.youversionapi.com/path/to/asset.ext", "format": "hls" } ], "playback_preview_sources": [ { "url": "https://video-cdn.youversionapi.com/path/to/asset.ext", "format": "hls" } ], "share_url": "https://www.bible.com/en/videos/52186" } ], "next_page_token": "eyJzdGFydF9hdCI6IDI2fQ==", "total_size": 215 }
json
application/json

Get a video resource by id.

GET
https://api.youversion.com
/v1/videos/{video_id}

Returns a video resource by its id. An unknown id, or a video that the calling app has no license for, returns 404. From then on, use the id in the response for this video. playback_sources holds its HLS source.

thumbnail.url is a Platform CDN URL. Its path carries this response's id and needs no app key, so load it as given. To select a resized rendition, add a size=thumb|card|full query parameter. Omit it for the full-size image.

Get a video resource by id. › path Parameters

video_id
​string · required

The unique video ID provided in the Platform.

Example: 52186

Get a video resource by id. › Headers

Accept-Language
​string

The localization preferred as a response to the request. See RFC 2616 section 14.4 for further details.

Example: en
Default: en

Get a video resource by id. › Responses

Successful request

id
​string · readOnly · required

The video id issued for this response. Use it for this video from then on; the same video can carry a different id in each response, so do not use it as a stable key for the video.

Example: eyJhbGciOiJFUzI1NiIsImtpZCI6ImV4YW1wbGUiLCJub25jZSI6ImFjYzc4ZWJjYmMzOWNjNzhlMWYxYjgxZiJ9.WTZESyfRI8PFoaMpnNOXtFPbBAiLLJNq8BHazhdBXQc-EMPbpohn5BKzE693VCvBhMaZDgkwg6_lM2nXMiUoXpYWxWRTnm76647Rn8u_WSss3QbFCgPOlmeCv_UCxk12jB768fG50f0fVEgAhYPjJlvK4r0W4l4k6ZKa5Q9Ff39Z9qBW7CpHrP2IRN4EIdfG7h6hGzxeMZ4iOuE7N1AQQtq0N_KlXQnA2-ZmpiLwdy0MJJC2t-Oq1VkFsKMSUs1rS1fluxLWFHiAWI3k0t7aCVTfSSjwWJAFKONaHJA5JpFy0QEYm78mVcJLK1dFh2ygHXFZ6OPZmiBdTdvlS3qUjEA.SrpbodXlcsFLw_KwGlD7u7T8LYePlhmlYKmqTJcVbL0BbQz_hszqg-PWx9A1rA5AvmTpHlMHaXlA3MyUI-ljeg
​object[] · readOnly · required

Playable sources for the video.

​object[] · readOnly · required

Preview clip sources.

organization_id
​string | null · uuid · readOnly

The id of the organization that publishes the video. Null when the publisher is not known.

Example: c3187cfe-a191-4088-9fb2-24c306d9eb38
title
​string | null · readOnly

Video title.

Example: 1 Samuel 17:45
description
​string | null · readOnly

Video description.

Example: Teaching clip description.
passage_ids
​array | null · readOnly

The Bible passages the video is about. Each is a chapter, verse or verse range such as GEN.1, JHN.3.16 or 1CO.13.4-5. Null when the video has no passage.

Example: ["1SA.17.45"]
language_tag
​string | null · readOnly

BCP 47 language tag for the video.

Example: en
runtime
​integer | null · readOnly

Runtime in seconds.

Example: 105
orientation
​string | null · enum · readOnly

Video orientation.

Enum values:
landscape
portrait
Example: portrait
​object
share_url
​string | null · readOnly

Share URL for the video.

Example: https://www.bible.com/en/videos/52186
GET/v1/videos/{video_id}
curl --request GET \ --url https://api.youversion.com/v1/videos/:video_id
shell
Example Responses
{ "id": "eyJhbGciOiJFUzI1NiIsImtpZCI6ImV4YW1wbGUiLCJub25jZSI6ImFjYzc4ZWJjYmMzOWNjNzhlMWYxYjgxZiJ9.WTZESyfRI8PFoaMpnNOXtFPbBAiLLJNq8BHazhdBXQc-EMPbpohn5BKzE693VCvBhMaZDgkwg6_lM2nXMiUoXpYWxWRTnm76647Rn8u_WSss3QbFCgPOlmeCv_UCxk12jB768fG50f0fVEgAhYPjJlvK4r0W4l4k6ZKa5Q9Ff39Z9qBW7CpHrP2IRN4EIdfG7h6hGzxeMZ4iOuE7N1AQQtq0N_KlXQnA2-ZmpiLwdy0MJJC2t-Oq1VkFsKMSUs1rS1fluxLWFHiAWI3k0t7aCVTfSSjwWJAFKONaHJA5JpFy0QEYm78mVcJLK1dFh2ygHXFZ6OPZmiBdTdvlS3qUjEA.SrpbodXlcsFLw_KwGlD7u7T8LYePlhmlYKmqTJcVbL0BbQz_hszqg-PWx9A1rA5AvmTpHlMHaXlA3MyUI-ljeg", "organization_id": "c3187cfe-a191-4088-9fb2-24c306d9eb38", "title": "1 Samuel 17:45", "description": "Teaching clip description.", "passage_ids": [ "1SA.17.45" ], "language_tag": "en", "runtime": 105, "orientation": "portrait", "thumbnail": { "url": "https://cdn.youversion.com/video-images/eyJhbGciOiJFUzI1NiIsImtpZCI6ImV4YW1wbGUiLCJub25jZSI6ImFjYzc4ZWJjYmMzOWNjNzhlMWYxYjgxZiJ9.WTZESyfRI8PFoaMpnNOXtFPbBAiLLJNq8BHazhdBXQc-EMPbpohn5BKzE693VCvBhMaZDgkwg6_lM2nXMiUoXpYWxWRTnm76647Rn8u_WSss3QbFCgPOlmeCv_UCxk12jB768fG50f0fVEgAhYPjJlvK4r0W4l4k6ZKa5Q9Ff39Z9qBW7CpHrP2IRN4EIdfG7h6hGzxeMZ4iOuE7N1AQQtq0N_KlXQnA2-ZmpiLwdy0MJJC2t-Oq1VkFsKMSUs1rS1fluxLWFHiAWI3k0t7aCVTfSSjwWJAFKONaHJA5JpFy0QEYm78mVcJLK1dFh2ygHXFZ6OPZmiBdTdvlS3qUjEA.SrpbodXlcsFLw_KwGlD7u7T8LYePlhmlYKmqTJcVbL0BbQz_hszqg-PWx9A1rA5AvmTpHlMHaXlA3MyUI-ljeg/delivery/images/0bae673f.jpg", "width": 640, "height": 360 }, "playback_sources": [ { "url": "https://video-cdn.youversionapi.com/path/to/asset.ext", "format": "hls" } ], "playback_preview_sources": [ { "url": "https://video-cdn.youversionapi.com/path/to/asset.ext", "format": "hls" } ], "share_url": "https://www.bible.com/en/videos/52186" }
json
application/json

verse of the daysapps