api.getbible.net

A getBible static API: every resource is a file served exactly as published. public, metered · tokens unlimited

Endpoints

Every path starts with a version segment. Each endpoint is an independent tree with its own documentation page, changing on its own schedule.

Machine-readable index of the endpoints and their OpenAPI documents: versions.json.

How to call it

Plain HTTPS GET requests, from any origin. Responses are JSON, plus .sha and .txt files as plain text. Nothing here accepts query strings or request bodies.

curl https://api.getbible.net/v2/path/to/document.json

• Allowed file types: .json, .sha, .txt.
• Methods: GET, HEAD, OPTIONS. Anything else answers 405.
• CORS is open: Access-Control-Allow-Origin: * on every response, preflights answer 204.
• Caching: Cache-Control: public, max-age=2592000 on documents and max-age=300 on checksum files; every response carries an ETag, so conditional requests answer 304.
• Compression: gzip (and brotli where available) on request.
• Health: GET /healthz answers {"status":"ok"}.

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.

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://api.getbible.net/v2/path/to/document.json

Tokens are issued to applications and partners by the getBible team; ask through getBible.net.

Errors

Every error is an RFC 9457 problem document with the media type application/problem+json:

{"type":"https://getbible.net/problems/not-found","title":"Not Found","status":404,"code":"not_found","detail":"No such resource on this API. ...","instance":"urn:request:..."}