YouVersion PlatformYouVersion Platform
PlatformLearn moreBiblesDev Docs
PartnersSupport
  • Overview
  • API Reference
  • SDKs
<  Back to Platform

YouVersion Platform

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

Platform Products

  • Platform Portal
  • Developer Documentation
  • App Management

Resources

  • Learn more
  • Support
  • Press inquiries

Legal

  • Privacy Policy
  • Terms of Use

© 2025 YouVersion. All rights reserved.

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
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
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
Schemas
Transformers
Transformers

organizations

Endpointhttps://api.youversion.com

Provides information about our publishing partners in the YouVersion platform. Use these to get information about the organizations which provide Bible versions.


Get a collection of organizations in the Platform.

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

The response will return a list of Organization objects.

Get a collection of organizations in the Platform. › query Parameters

bible_id
integer · int32 · required

The Bible version identifier

Example: 111

Get a collection of organizations in the Platform. › Headers

Accept-Language
string · required

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

Example: en

Get a collection of organizations in the Platform. › Responses

Successful request

object[] · readOnly · required
next_page_token
string · readOnly

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

Example: eyJzdGFydF9hdCI6IDI2fQ==
GET/v1/organizations
curl --request GET \
  --url 'https://api.youversion.com/v1/organizations?bible_id=%3Cnumber%3E' \
  --header 'Accept-Language: <string>'
shell
Example Responses
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "parent_organization_id": "00000000-0000-0000-0000-000000000000",
      "name": "Biblica, Inc.",
      "description": "This is a lorem ipsum description of the organization and its purpose and goals and what it does and what it does not do.",
      "email": {},
      "phone": {},
      "primary_language": "en",
      "website_url": "https://www.biblica.com",
      "address": {
        "formatted_address": "2001 Northwest 178th street Oklahoma City, OK 73102",
        "formatted_locality": "Oklahoma City, OK",
        "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
        "latitude": 35.654724,
        "longitude": -97.547843,
        "administrative_area_level_1": {
          "short_name": "OK",
          "long_name": "Oklahoma"
        },
        "locality": {
          "short_name": "OK",
          "long_name": "Oklahoma"
        },
        "country": {
          "short_name": "OK",
          "long_name": "Oklahoma"
        }
      }
    }
  ],
  "next_page_token": "eyJzdGFydF9hdCI6IDI2fQ=="
}
json
application/json

Get details about a specific organization in the Platform.

GET
https://api.youversion.com
/v1/organizations/{organization_id}

Get a single organization resource by its id.

Get details about a specific organization in the Platform. › path Parameters

organization_id
string · uuid · required

The Organization unique ID provided in the Platform.

Example: 550e8400-e29b-41d4-a716-446655440000

Get details about a specific organization in the Platform. › Headers

Accept-Language
string · required

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

Example: en

Get details about a specific organization in the Platform. › Responses

Successful request

The Organization Resource in the Platform.
id
string · uuid · required

The unique identifier of the organization in the Platform.

Example: 550e8400-e29b-41d4-a716-446655440000
parent_organization_id
string | null · uuid

The id of the parent organization if one exists.

Example: 550e8400-e29b-41d4-a716-446655440000
name
string

Publisher's name in the language negotiated by Accept-Language headers. If none match known translations, then the primary language of the publisher is used. Whichever language is chosen will be sent back in the Content-Language header.

Example: Biblica, Inc.
description
string

Description of the organization. It's purpose and goals, values and mission, etc.

Example: This is a lorem ipsum description of the organization and its purpose and goals and what it does and what it does not do.
email
string | null

The contact email address for the organization if provided.

phone
string | null

The contact phone number for the organization if provided.

primary_language
string

The primary language of the organization.

Example: en
website_url
string

The web site for the organization.

Example: https://www.biblica.com
object

The Address Schema belonging to the Organization Resource in the Platform.

GET/v1/organizations/{organization_id}
curl --request GET \
  --url https://api.youversion.com/v1/organizations/:organization_id \
  --header 'Accept-Language: <string>'
shell
Example Responses
{
  "id": "00000000-0000-0000-0000-000000000000",
  "parent_organization_id": "00000000-0000-0000-0000-000000000000",
  "name": "Biblica, Inc.",
  "description": "This is a lorem ipsum description of the organization and its purpose and goals and what it does and what it does not do.",
  "email": {},
  "phone": {},
  "primary_language": "en",
  "website_url": "https://www.biblica.com",
  "address": {
    "formatted_address": "2001 Northwest 178th street Oklahoma City, OK 73102",
    "formatted_locality": "Oklahoma City, OK",
    "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
    "latitude": 35.654724,
    "longitude": -97.547843,
    "administrative_area_level_1": {
      "short_name": "OK",
      "long_name": "Oklahoma"
    },
    "locality": {
      "short_name": "OK",
      "long_name": "Oklahoma"
    },
    "country": {
      "short_name": "OK",
      "long_name": "Oklahoma"
    }
  }
}
json
application/json

Get bibles associated with a specific organization in the Platform.

GET
https://api.youversion.com
/v1/organizations/{organization_id}/bibles

Get bibles associated with a specific organization by its id.

Get bibles associated with a specific organization in the Platform. › path Parameters

organization_id
string · uuid · required

The Organization unique ID provided in the Platform.

Example: 550e8400-e29b-41d4-a716-446655440000

Get bibles associated with a specific organization in the Platform. › query Parameters

page_size

The number of items to return in the collection. Numeric values must be between 1 and 100. Special value "" is supported only when used in combination with the fields parameter and when the client requests three or fewer fields (see fields parameter). When "" is used the server will return all matching items for the requested resource (no numeric page limit).

fields[]
string[]

A list of top-level fields to include in each resource object. Use bracket notation to pass multiple values, for example: fields[]=id&fields[]=name&fields[]=language. When provided, page_size=* is allowed only if the number of fields requested is three (3) or fewer.

Example: ["id","name","language"]
page_token
string

The page token to retrieve results from.

Example: eyJzdGFydF9hdCI6IDI2fQ==

Get bibles associated with a specific organization in the Platform. › Responses

Successful request

object[] · readOnly · required
next_page_token
string · readOnly

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

Example: eyJzdGFydF9hdCI6IDI2fQ==
total_size
integer · int32

Total number of bibles in collection matching parameters.

Example: 42
GET/v1/organizations/{organization_id}/bibles
curl --request GET \
  --url https://api.youversion.com/v1/organizations/:organization_id/bibles
shell
Example Responses
{
  "data": [
    {
      "id": 111,
      "abbreviation": "NIV",
      "promotional_content": "\"<p>Biblica is the worldwide publisher and translation sponsor of the New International Version—one of the most widely read contemporary English versions of the Bible. </p> <p>At Biblica, we believe that with God, all things are possible. Partnering with other ministries and people like you, we are reaching the world with God’s Word, providing Bibles that are easier to understand and faster to receive. When God’s Word is put into someone’s hands, it has the power to change everything. </p> <p>To learn more, visit <a href=\"https://www.biblica.com/privacy-policy/\">biblica.com</a> and <a href=\"http://facebook.com/Biblica\">facebook.com/Biblica</a>.</p> <p> </p>\"",
      "copyright": "The Holy Bible, New International Version® NIV® Copyright © 1973, 1978, 1984, 2011 by Biblica, Inc.® Used by Permission of Biblica, Inc.® All rights reserved worldwide.",
      "info": "The Holy Bible",
      "publisher_url": "https://www.biblica.com/yv-learn-more/",
      "language_tag": "en",
      "localized_abbreviation": "NIV",
      "localized_title": "New International Version",
      "title": "New International Version 2011",
      "books": [
        "string"
      ],
      "youversion_deep_link": "https://www.bible.com/versions/111",
      "organization_id": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "next_page_token": "eyJzdGFydF9hdCI6IDI2fQ==",
  "total_size": 42
}
json
application/json

licensesverse of the days