Bible API

curl "https://bible-api.dws-cloud.com/v1/verses/John%203:16"

GET /v1/verses/:reference Try it

Get verses by reference. Supports single verses, ranges, full chapters, and comma-separated references with context inheritance.

Query: translation - Translation ID (default: web)

GET /v1/chapters/:book/:chapter Try it

Get a full chapter with navigation hints. Designed for sequential reading apps.

Query: translation - Translation ID (default: web)

Response includes: navigation.previous and navigation.next with testament field (OT/NT/AP) for client-side boundary handling.

GET /v1/search Try it

Full-text search across all verses.

Query: q - Search query (required) | translation - Translation ID | book - Filter by book (e.g., ROM) | testament - Filter by OT, NT, or AP | limit - Results per page (default: 20) | offset - Pagination offset

GET /v1/books Try it

List all books with chapter counts and metadata.

Query: testament - Filter by OT, NT, or AP

GET /v1/translations Try it

List available translations.

GET /v1/random Try it

Get a random verse.

Query: translation - Translation ID | book - Limit to specific book | testament - Limit to OT, NT, or AP

GET /v1/health Try it

Health check endpoint. Returns API status and database stats.

{
  "reference": "John 3:16",
  "translation": {
    "id": "web",
    "name": "World English Bible"
  },
  "verses": [{
    "book": "JHN",
    "book_name": "John",
    "chapter": 3,
    "verse": 16,
    "text": "For God so loved the world..."
  }],
  "text": "For God so loved the world..."
}