Lets Read The Bible Scripture, prayer, and peace

Lets Read The Bible Monthly Goal

Lets Read The Bible is kept free and ad free through donations. Help us cover the monthly operating cost and keep Scripture reading peaceful and accessible.

May, 2026 $5.00 / $500.00

Developer

Lets Read The Bible API

This API is built for native iPhone, iPad, and Android applications. Authenticate with a bearer token created from your account page or returned by the mobile login endpoint.

Open OpenAPI JSON Manage API Tokens

Authentication

Use the token as a bearer credential in the Authorization header.

Authorization: Bearer lrtb_your_generated_token

Tokens created from the account dashboard are shown only once. Store them securely in the device keychain or secure enclave flow for your native app.

Quick Start

1. Create a token

Open your account dashboard, create a native app token, and copy it immediately. Full app access is ideal for iPhone, iPad, and Android clients.

2. Test login from your app

POST https://letsreadthebible.com/api/v1/auth/login
Content-Type: application/json

{
  "email": "you@example.com",
  "password": "your-password",
  "device_name": "My iPhone"
}

3. Load the home feed

GET https://letsreadthebible.com/api/v1/home

Scopes

*

Full app access

Allows native apps to read and write on behalf of the signed-in user.

profile.read

Profile read

Read account dashboard details and donation history.

bible.read

Bible read

Browse books, chapters, verses, and saved explanations.

blog.read

Blog read

Read blog posts and categories.

prayers.read

Prayer read

Read prayers, prayer wall items, and candle wall items.

search.read

Search read

Run global and Bible topic search.

Endpoints

GET /api/v1/status No

Quick health check for the mobile app.

GET /api/v1/home No

Return the app home feed with featured verse, stories, prayers, and donation goal data.

POST /api/v1/auth/login No

Authenticate a user and return a bearer token for native apps.

POST /api/v1/auth/register No

Create an account and return a bearer token.

POST /api/v1/auth/logout Bearer

Revoke the current bearer token.

GET /api/v1/me Bearer

Return the signed-in user profile and token details.

GET /api/v1/account/dashboard Bearer

Return account counts, last-read details, and recent donation history.

GET /api/v1/account/favorites Bearer

Return favorite verses and favorite chapters.

GET /api/v1/account/bookmarks Bearer

Return saved bookmarks.

GET /api/v1/account/donations Bearer

Return the user donation history.

POST /api/v1/contact Optional

Send a support or feedback message from the native app through the Lets Read The Bible contact mailer.

POST /api/v1/push/register Optional

Register or refresh an iPhone or iPad device token for future push notifications.

POST /api/v1/support/app-store Optional

Verify a signed StoreKit transaction and record an App Store support purchase for the monthly goal and account history.

POST /api/v1/account/favorites/verses/toggle Bearer

Toggle a verse favorite for the user.

POST /api/v1/account/favorites/chapters/toggle Bearer

Toggle a chapter favorite for the user.

POST /api/v1/account/bookmarks/toggle Bearer

Toggle a verse or chapter bookmark.

GET /api/v1/bible/books No

Return the grouped Bible index.

GET /api/v1/bible/topics/{topicSlug} No

Return the verse search results for one curated Bible topic.

GET /api/v1/bible/books/{bookSlug} No

Return one book with chapter numbers.

GET /api/v1/bible/books/{bookSlug}/chapters/{chapter} No

Return one full chapter with previous and next chapter links.

GET /api/v1/bible/books/{bookSlug}/chapters/{chapter}/verses/{verse} No

Return one verse and its saved explanation, if available.

POST /api/v1/bible/books/{bookSlug}/chapters/{chapter}/verses/{verse}/explanation Bearer

Generate or return a saved verse explanation.

GET /api/v1/prayers No

Return the full Catholic prayer library listing.

GET /api/v1/prayers/{slug} No

Return one prayer with instructions and FAQs.

GET /api/v1/prayer-requests No

Return the public prayer wall feed.

POST /api/v1/prayer-requests Bearer

Submit a new prayer request from a signed-in app user.

POST /api/v1/prayer-requests/{id}/pray Optional

Mark that the user prayed for an intention and return the updated prayer count.

POST /api/v1/prayer-requests/{id}/comments Bearer

Add a prayer-wall comment or reply from a verified signed-in user.

GET /api/v1/candles No

Return the public candle wall.

POST /api/v1/candles Bearer

Submit a free prayer candle from a signed-in user.

GET /api/v1/blog/categories No

Return the public blog categories and post counts.

GET /api/v1/blog/posts No

Return paginated published blog posts.

GET /api/v1/blog/posts/{slug} No

Return one published blog post with FAQ items.

GET /api/v1/search No

Run a global site search or topic search across Bible, prayers, explanations, and blog posts.