---
title: "Search the text of Scripture"
method: GET
path: "/scripture"
---

# Search the text of Scripture

`GET /scripture`

## Request

- Base URL: `https://vineverse.bible/api/v1`
- URL: `https://vineverse.bible/api/v1/scripture`
- Auth: none required

Full-text search across all 31,102 verses of the Berean Standard Bible — how you find a passage you can half-remember but cannot cite.

All words must appear in the same verse. Wrap words in double quotes to require them adjacent as a phrase ("a still small voice"). Results rank by how much of the verse is your query, so short exact matches come first.

## Query parameters

- `q` string, required
- `book` string
- `testament` 'OT' | 'NT'
- `limit` integer
- `offset` integer

## Response `200`

Matching verses, best match first.

- ScriptureResults
  - `query` string, required
  - `total` integer, required
  - `offset` integer
  - `count` integer, required
  - `terms` string[]: How the query was tokenised.
  - `phrases` string[]: Quoted runs, required adjacent.
  - `translation` 'BSB'
  - `hits` object[], required
    - `osis` string
    - `reference` string
    - `url` string
    - `text` string
    - `book` string
    - `testament` 'OT' | 'NT'
  - `licence` Licence: Carried on every response. The obligation is inherited by anyone who redistributes the data, not discharged by us. `document` is the licence of the specific document fetched, which is CC-BY-SA-4.0 for anything under sa/ and is the value to honour over the blanket statement.
    - `text` string
    - `data` string
    - `document` string: SPDX-style id for this document, e.g. "CC-BY-4.0".
    - `shareAlike` string
    - `reason` string
    - `attribution` string, uri

## Other responses

- `400`: The reference or parameter could not be parsed.
- `429`: Too many requests. Carries Retry-After. See the rate limit note in `info`.

---

[API](https://skmtc.dev/vineverse/apis/vineverse-api.md) · [All operations](https://skmtc.dev/vineverse/apis/vineverse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vineverse/apis/vineverse-api/revisions/39d053a686bb?raw)