Transformers

languages

Endpoint

Provides data about the languages supported by the YouVersion platform. Use for presenting language options in your UI.

Get a collection of languages supported in the Platform.

GET

https://api.youversion.com

/v1/languages

Get a collection of language objects. Add the Country parameter to filter to prominent languages for that country.

Get a collection of languages supported 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==

country

string

The ISO 3166 2 character country code

Example: US

bibles_available

boolean

Filter languages based on whether Bible content is available for that language.

Default: false

Get a collection of languages supported 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 languages in collection matching parameters.

Example: 6000

GET/v1/languages

curl --request GET \
  --url https://api.youversion.com/v1/languages

shell

Example Responses

{
  "data": [
    {
      "id": "en",
      "language": "sr",
      "script": "Latn",
      "script_name": "Latin",
      "aliases": [],
      "display_names": {
        "en": "Serbian (Latin)"
      },
      "scripts": [
        "Cyrl",
        "Latn"
      ],
      "variants": [
        "1996",
        "fonipa"
      ],
      "countries": [
        "RS",
        "BA",
        "ME"
      ],
      "text_direction": "rtl",
      "writing_population": 1327104050,
      "speaking_population": 1636485840,
      "default_bible_id": 3034
    }
  ],
  "next_page_token": "eyJzdGFydF9hdCI6IDI2fQ==",
  "total_size": 6000
}

json

application/json

Get details about a specific language in the Platform.

GET

https://api.youversion.com

/v1/languages/{language_id}

Get a single language resource by its BCP47 language code.

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

language_id

string · required

The language identifier uses the canonical BCP 47 language code, optionally including the script subtag when it distinguishes writing systems (for example, sr-Latn vs sr-Cyrl). Other subtags—region, variants, and extensions—are excluded because they represent contextual or user-specific preferences rather than the intrinsic identity of the language. This keeps identifiers stable, minimal, and reusable across countries and use cases.

Example: en

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

Successful request

Region-agnostic language resource keyed by canonical BCP 47 language or language+script. Variants and a simple extensions indicator are included for completeness, but regions and full extension data are excluded.

id

string · pattern: ^[a-z]{2,3}(?:-[A-Z]… · required

Canonical BCP 47 id limited to language or language+script. Region, variants, and extensions are not allowed.

Example: en

language

string · pattern: ^[a-z]{2,3}$ · required

ISO 639 canonical language subtag

Example: sr

script

string | null · pattern: ^[A-Z][a-z]{3}$

ISO 15924 script code if present in id

Example: Latn

script_name

string | null

The English name for the script

Example: Latin

aliases

string[]

Deprecated or legacy subtags mapped during canonicalization for this language.

Example: []

object

Localized display names for the language/script combination

scripts

string[]

All scripts known for this language (CLDR/ISO-15924)

Example: ["Cyrl","Latn"]

variants

string[]

Variants associated with this language (not part of the id)

Example: ["1996","fonipa"]

countries

string[]

Ids of countries where this language is used or supported. Extended details can be retrieved from the countries API with the provided id.

Example: ["RS","BA","ME"]

text_direction

string · enum

Default text direction for this language. ltr is left to right and rtl is right to left.

Enum values:

ltr

rtl

Example: rtl

writing_population

integer · int32

Estimated number of souls that write in this language.

Example: 1327104050

speaking_population

integer · int32

Estimated number of souls that speak in this language.

Example: 1636485840

default_bible_id

integer · int32

The chosen default Bible version for this language.

Example: 3034

highlights licenses

Get a collection of languages supported in the Platform.

GET

https://api.youversion.com

/v1/languages

Get a collection of language objects. Add the Country parameter to filter to prominent languages for that country.

Get a collection of languages supported in the Platform. › query Parameters

page_size

fields[]

string[]

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

page_token

string

The page token to retrieve results from.

Example: eyJzdGFydF9hdCI6IDI2fQ==

country

string

The ISO 3166 2 character country code

Example: US

bibles_available

boolean

Filter languages based on whether Bible content is available for that language.

Default: false

Get a collection of languages supported 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 languages in collection matching parameters.

Example: 6000

Get details about a specific language in the Platform.

GET

https://api.youversion.com

/v1/languages/{language_id}

Get a single language resource by its BCP47 language code.

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

language_id

string · required

Example: en

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

Successful request

id

string · pattern: ^[a-z]{2,3}(?:-[A-Z]… · required

Canonical BCP 47 id limited to language or language+script. Region, variants, and extensions are not allowed.

Example: en

language

string · pattern: ^[a-z]{2,3}$ · required

ISO 639 canonical language subtag

Example: sr

script

string | null · pattern: ^[A-Z][a-z]{3}$

ISO 15924 script code if present in id

Example: Latn

script_name

string | null

The English name for the script

Example: Latin

aliases

string[]

Deprecated or legacy subtags mapped during canonicalization for this language.

Example: []

object

Localized display names for the language/script combination

scripts

string[]

All scripts known for this language (CLDR/ISO-15924)

Example: ["Cyrl","Latn"]

variants

string[]

Variants associated with this language (not part of the id)

Example: ["1996","fonipa"]

countries

string[]

Ids of countries where this language is used or supported. Extended details can be retrieved from the countries API with the provided id.

Example: ["RS","BA","ME"]

text_direction

string · enum

Default text direction for this language. ltr is left to right and rtl is right to left.

Enum values:

ltr

rtl

Example: rtl

writing_population

integer · int32

Estimated number of souls that write in this language.

Example: 1327104050

speaking_population

integer · int32

Estimated number of souls that speak in this language.

Example: 1636485840

default_bible_id

integer · int32

The chosen default Bible version for this language.

Example: 3034