Quick Reference

Copy page

This page provides a quick overview of the YouVersion Bible API endpoints and common usage patterns.

Base URL

• Production: https://api.youversion.com/v1

Authentication

All requests require the X-YVP-App-Key header:

Code
X-YVP-App-Key: YOUR_APP_KEY

Endpoints Overview

Method	Endpoint	Description
GET	/bibles	Get available Bible versions
GET	/bibles/{version_id}	Get specific Bible details
GET	/bibles/{version_id}/books	Get books for a Bible
GET	/bibles/{version_id}/books/{book_usfm}	Get book content
GET	/bibles/{version_id}/books/{book_usfm}/chapters	Get chapters for a book
GET	/bibles/{version_id}/books/{book_usfm}/chapters/{chapter_number}/verses	Get verses for a chapter

Common Parameters

Query Parameters

• language_ranges: Comma-separated language codes (e.g., en,es,fr)
• next_page_token: For pagination

Path Parameters

• version_id: Bible version identifier (integer)
• book_usfm: 3-character USFM book code (e.g., MAT, JHN)
• chapter_number: Chapter number (integer)

Response Format

All successful responses follow this format:

Code
{
  "data": [...],
  "next_page_token": "string"
}

Common Bible IDs

ID	Abbreviation	Name
12	ASV	American Standard Version
111	NIV	New International Version
206	WEBUS	World English Bible, American English Edition, without Strong's Numbers
3034	BSB	Berean Standard Bible

Common Book USFM Codes

Book	USFM Code
Genesis	GEN
Exodus	EXO
Matthew	MAT
John	JHN
Romans	ROM
Revelation	REV

Example Requests

Get All Bible Versions

Code
curl -H "X-YVP-App-Key: YOUR_APP_KEY" \
     https://api.youversion.com/v1/bibles

Get BSB Bible Details

Code
curl -H "X-YVP-App-Key: YOUR_APP_KEY" \
     https://api.youversion.com/v1/bibles/3034

Get Books in BSB

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

Get John Chapter 3 Verses

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

Error Codes

Code	Meaning
200	Success
204	No Content
400	Bad Request
401	Unauthorized
404	Not Found
406	Not Acceptable

Rate Limiting

• Check X-RateLimit-* headers for rate limit information
• Implement exponential backoff for 429 responses

Best Practices

1. Cache responses when possible
2. Handle errors gracefully
3. Use appropriate timeouts
4. Validate parameters before requests
5. Respect rate limits

SDKs and Libraries

While no official SDKs are available, you can use any HTTP client library:

• JavaScript: fetch, axios, node-fetch
• Python: requests, httpx
• Ruby: net/http, httparty
• PHP: curl, Guzzle
• Go: net/http

Need More Details?

• Full API Reference - Complete endpoint documentation
• Getting Started - Step-by-step guide
• Error Codes - Detailed error information