---
title: "Hybrid search across Bible verses"
method: GET
path: "/search"
tags: ["Search"]
---

# Hybrid search across Bible verses

`GET /search`

## Request

- Base URL: `https://api.holydb.com/v1`
- URL: `https://api.holydb.com/v1/search`
- Auth: none declared

Keyword + vector search over verse text, passage headings and modern renderings. A query shaped like a citation (`John 3:16`, `John 3`) short-circuits to an exact verse or chapter lookup instead.

## Query parameters

- `q` string
- `t` string: Translation abbreviation; filters results when present.

## Response `200`

Matching verses, best match first

- SearchResponse
  - `total` number, required
  - `hits` SearchVerse[], required
    - `translation` string, required
    - `bookId` number, required
    - `bookName` string, required
    - `chapter` number, required
    - `verse` number, required
    - `text` string, required
    - `passage` string

## Other responses

- `400`: Missing q

---

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