# Bible — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access Bible verses and chapters across multiple translations, retrieve daily devotional content, and build scripture-based applications with real-time data from Bible.com. Get specific verses, entire chapters, or the verse of the day to enhance your spiritual reading and study experience.

**Category:** Other | **Website:** [www.bible.com/](https://www.bible.com/) | **Docs:** [parse.bot/marketplace/6453d4b9-c678-43b1-84a4-ada9ee6f81d2/bible-com-api](https://parse.bot/marketplace/6453d4b9-c678-43b1-84a4-ada9ee6f81d2/bible-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/bible/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get chapter

Retrieve all verses of a Bible chapter for a given book, chapter number, and translation version. Returns structured verse data with USFM identifiers, verse numbers, text content, copyright information, and navigation to adjacent chapters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book` | string | Yes | Three-letter USFM book code (e.g. GEN, EXO, LEV, NUM, DEU, JOS, JDG, RUT, 1SA, 2SA, 1KI, 2KI, PSA, PRO, ISA, JER, EZK, DAN, HOS, JOL, AMO, OBA, JON, MIC, NAH, HAB, ZEP, HAG, ZEC, MAL, MAT, MRK, LUK, JHN, ACT, ROM, 1CO, 2CO, GAL, EPH, PHP, COL, 1TH, 2TH, 1TI, 2TI, TIT, PHM, HEB, JAS, 1PE, 2PE, 1JN, 2JN, 3JN, JUD, REV). |
| `chapter` | string | Yes | Chapter number (e.g. 1, 2, 3). |
| `version_id` | string | No | Numeric Bible version ID. 111 = NIV, 1 = KJV, 59 = ESV, 116 = NLT, 114 = NKJV, 97 = MSG, 1713 = CSB, 2692 = NASB2020, 1588 = AMP, 107 = NET. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bible/get-chapter \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"book":"<string>","chapter":"<string>","version_id":"<string>"}'
```

### Get verse

Retrieve a specific verse or verse range across multiple Bible translations. Returns the verse text from up to 10 popular English translations simultaneously. Supports single verses (JHN.3.16) and ranges (JHN.3.16-18).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `usfm` | string | Yes | USFM verse reference. Single verse format: BOOK.CHAPTER.VERSE (e.g. JHN.3.16, ROM.8.28). Range format: BOOK.CHAPTER.START-END (e.g. JHN.3.16-18, PSA.23.1-6). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bible/get-verse \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"usfm":"<string>"}'
```

### Get verse of the day

Retrieve today's Verse of the Day from Bible.com. Returns the verse reference, text content, date, and an associated image URL. The verse changes daily and is the same for all users on a given day.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `version_id` | string | No | Numeric Bible version ID. 111 = NIV, 1 = KJV, 59 = ESV, 116 = NLT, 114 = NKJV, 97 = MSG, 1713 = CSB, 2692 = NASB2020, 1588 = AMP, 107 = NET. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bible/get-verse-of-the-day \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"version_id":"<string>"}'
```

### Get verses

Retrieve all verses of a Bible chapter as a flat list of verse objects. Similar to get_chapter but returns only the verse data without chapter navigation metadata. Useful for extracting verse text in bulk for a specific chapter and version.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book` | string | Yes | Three-letter USFM book code (e.g. GEN, EXO, LEV, NUM, DEU, JOS, JDG, RUT, 1SA, 2SA, 1KI, 2KI, PSA, PRO, ISA, JER, EZK, DAN, HOS, JOL, AMO, OBA, JON, MIC, NAH, HAB, ZEP, HAG, ZEC, MAL, MAT, MRK, LUK, JHN, ACT, ROM, 1CO, 2CO, GAL, EPH, PHP, COL, 1TH, 2TH, 1TI, 2TI, TIT, PHM, HEB, JAS, 1PE, 2PE, 1JN, 2JN, 3JN, JUD, REV). |
| `chapter` | string | Yes | Chapter number (e.g. 1, 2, 3). |
| `version_id` | string | No | Numeric Bible version ID. 111 = NIV, 1 = KJV, 59 = ESV, 116 = NLT, 114 = NKJV, 97 = MSG, 1713 = CSB, 2692 = NASB2020, 1588 = AMP, 107 = NET. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bible/get-verses \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"book":"<string>","chapter":"<string>","version_id":"<string>"}'
```

### Get versions

List all available Bible versions (translations) for a given language. Returns version IDs, abbreviation codes, titles, and publisher information. Defaults to English versions. The language parameter accepts a 3-letter language tag (e.g. eng, spa, fra), a 2-letter ISO 639-1 code (e.g. en, es, fr), or a language name (e.g. English, Spanish). Only versions available on the first page of results for the matching language are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language filter. Accepts a 3-letter language tag (e.g. eng, spa, fra, por), a 2-letter ISO 639-1 code (e.g. en, es, fr), or a language local name (e.g. English). Defaults to eng (English). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bible/get-versions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.