query.getbible.net
The getBible query API: Scripture references to verses (the librarian's select). public, metered · tokens unlimited
Endpoints
Every path starts with a version segment. Each version is served by its own service and has its own documentation page and OpenAPI document.
| Version | Route | Documentation | OpenAPI |
|---|---|---|---|
v2 | GET /v2/{translation}/{reference} | /v2/ | openapi.json |
v3 | GET /v3/{translation}/{reference} | /v3/ | openapi.json |
How to call it
curl https://query.getbible.net/v2/kjv/John3:16- Responses are JSON with open CORS (
Access-Control-Allow-Origin: *); preflights answer204. - Health:
GET /healthz; readiness (the service can read scripture):GET /readyz. - Every error is an RFC 9457 problem document (
application/problem+json).
Access
This endpoint is public and metered. Anonymous callers share a budget per client address; callers with a bearer token are not limited at all.
| Budget (per address) | Value |
|---|---|
| Sustained rate | 50 requests per second, bursts up to 250 |
| Per hour | about 100000 requests |
| Per day | about 1000000 requests |
| Concurrent connections | 100 |
Budgets are enforced as token buckets, so steady traffic under the quota is never touched and bursts above it are slowed with a 429 rather than cut off.
Using a token
Send it as a bearer credential. Tokens never go in the URL.
curl -H "Authorization: Bearer gb..." https://query.getbible.net/v2/kjv/John3:16Tokens are issued to applications and partners by the getBible team; ask through getBible.net.