Bible API Docs

Quick reference for available endpoints
View JSON
GET
/bible/list_books
List all Bible books
GET
/bible/list_chapters/{book}
List chapters in a book
GET
/bible/{book}
List chapters in a book
GET
/bible/{book}/{chapter}
Get all verses in a chapter
GET
/bible/{book}/{chapter}/{verse}
Get specific verse
GET
/bible/{book}/{chapter}/{start-end}
Get verse range
GET
/bible/search?q={query}
Search Bible text
GET
/bible/random_verse
Get random verse
GET
/bible/v2/search?q={query}&match={any|all|phrase}&case_sensitive={true|false}
OpenSearch full-text search. match defaults to any; case_sensitive defaults to false and requires the case-preserving index mapping.
GET
/bible/v2/suggest?q={prefix}
Predictive suggestions
PUT
/bible/v2/synonyms/{set}
Replace synonym set
Auth: JWT (scope: synonyms:write)
POST
/bible/v2/synonyms/{set}
Append to synonym set
Auth: JWT (scope: synonyms:write)
DELETE
/bible/v2/synonyms/{set}
Remove from synonym set
Auth: JWT (scope: synonyms:write)
POST
/auth/google/token
Exchange Google ID token for app JWT + session
GET
/auth/config
Auth configuration (Google client id)
GET
/auth/me
Get current session token
POST
/auth/logout
Clear session
POST
/admin/token
Mint token with X-Internal-Secret
Auth: X-Internal-Secret header
GET
/admin/rate-limit/{ip}
Check IP rate limit status
POST
/admin/block-ip
Manually block an IP
DELETE
/admin/unblock-ip/{ip}
Unblock an IP
GET
/admin/blocked-ips
List blocked IPs
GET
/health
Readiness probe (ops loopback :8000/health; GET /health/live for liveness)
GET
/v2
Web UI (Google login + search/suggest)
GET
/docs
API documentation (HTML)
GET
/docs.json
API documentation (JSON)