# Bible API
> The Bible as an API. Fetch any verse or passage by reference — a single verse like John 3:16 or a range like Psalms 23:1-3 or Genesis 1:1-5 — and get the clean verse text, the individual verses with their book, chapter and verse numbers, and the translation name; pull a random verse for verse-of-the-day features; and list all available translations, including the World English Bible, King James Version, American Standard Version, Bible in Basic English, the Chinese Union Version and more. Live from bible-api.com. Ideal for Bible and devotional apps, church and ministry websites, verse-of-the-day widgets and study tools. Open scripture data.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/bible-api/..."
```

## Pricing
- **Free** (Free) — 4,200 calls/Mo, 2 req/s
- **Starter** ($3/Mo) — 58,000 calls/Mo, 10 req/s
- **Pro** ($11/Mo) — 300,000 calls/Mo, 25 req/s
- **Mega** ($28/Mo) — 1,480,000 calls/Mo, 60 req/s

## Endpoints

### Bible

#### `GET /v1/random` — A random verse

**Parameters:**
- `translation` (query, optional, string) — Translation id (default web)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bible-api/v1/random"
```

**Response:**
```json
{
    "data": {
        "verse": {
            "book": "Joshua",
            "text": "the king of Madon, one; the king of Hazor, one;",
            "verse": 19,
            "chapter": 12,
            "reference": "Joshua 12:19",
            "translation": "World English Bible"
        }
    },
    "meta": {
        "timestamp": "2026-05-31T15:47:04.938Z",
        "request_id": "7bab2ae7-9f7b-4eb0-b9a2-778e37e25311"
    },
    "status": "ok",
    "message": "Random verse retrieved",
    "success": true
}
```

#### `GET /v1/translations` — Available translations

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bible-api/v1/translations"
```

**Response:**
```json
{
    "data": {
        "count": 17,
        "translations": [
            {
                "id": "cherokee",
                "name": "Cherokee New Testament",
                "license": "Public Domain",
                "language": "Cherokee",
                "language_code": "chr"
            },
            {
                "id": "cuv",
                "name": "Chinese Union Version",
                "license": "Public Domain",
                "language": "Chinese",
                "language_code": "zh-tw"
            },
            {
                "id": "bkr",
                "name": "Bible kralická",
                "license": "Public Domain",
                "language": "Czech",
                "language_code": "cze"
            },
            {
                "id": "asv",
                "name": "American Standard Version (1901)",
                "license": "Public Domain",
                "language": "English",
                "language_code": "eng"
            },
            {
                "id": "bbe",
                "name": "Bible in Basic English",
                "license": "Public Domain",
                "language": "English",
                "language_code": "eng"
            },
            {
                "id": "darby",
                "name": "Darby Bible",
                "license": "Public Domain",
                "language": "English",
                "language_code": "eng"
            },
            {
                "id": "dra",
               
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/verse` — A verse or passage

**Parameters:**
- `reference` (query, required, string) — Verse or passage, e.g. John 3:16 or Psalms 23:1-3 Example: `John 3:16`
- `translation` (query, optional, string) — Translation id (default web)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bible-api/v1/verse?reference=John+3%3A16"
```

**Response:**
```json
{
    "data": {
        "passage": {
            "text": "For God so loved the world, that he gave his one and only Son, that whoever believes in him should not perish, but have eternal life.",
            "verses": [
                {
                    "book": "John",
                    "text": "For God so loved the world, that he gave his one and only Son, that whoever believes in him should not perish, but have eternal life.",
                    "verse": 16,
                    "chapter": 3
                }
            ],
            "reference": "John 3:16",
            "translation": "World English Bible",
            "verse_count": 1,
            "translation_id": "web"
        }
    },
    "meta": {
        "timestamp": "2026-05-31T15:47:05.324Z",
        "request_id": "18f6121a-1238-47e8-8558-7cbf53d559a5"
    },
    "status": "ok",
    "message": "Verse retrieved",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Source & options

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bible-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Bible scripture. /v1/verse = a verse or passage by reference (e.g. John 3:16, Psalms 23:1-3, Genesis 1:1-5) in a chosen translation; /v1/random = a random verse; /v1/translations = the available translations (WEB, KJV, ASV, BBE, Cherokee, Chinese Union and more). Default translation is 'web'.",
        "source": "bible-api.com",
        "endpoints": [
            "/v1/verse",
            "/v1/random",
            "/v1/translations",
            "/v1/meta"
        ],
        "default_translation": "web (World English Bible)"
    },
    "meta": {
        "timestamp": "2026-05-31T15:47:05.403Z",
        "request_id": "dbfa6f0d-2909-4b36-8074-4b71958137c7"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/bible-api
OpenAPI spec: https://www.oanor.com/api/bible-api/openapi.json