🌐 English · Português (BR) · Español
Free, no-key, read-only public Bible API. Verses, chapters, books and versions across 86 Bible translations in 32 languages — served from Cloudflare's edge with aggressive caching. Powers api.midvash.com.
- No API key, no auth, no signup. Just
GET. - CORS enabled for direct browser use.
- Immutable content, cached for a year — fast everywhere.
- Built on Cloudflare Workers + R2.
Base URL: https://api.midvash.com
| Method | Path | Description |
|---|---|---|
GET |
/v1/versions |
List all versions (?language=en to filter) |
GET |
/v1/versions/{slug} |
Version metadata |
GET |
/v1/books |
List all books (?testament=old|new) |
GET |
/v1/books/{slug} |
Book metadata |
GET |
/v1/{version}/{book}/{chapter} |
Full chapter |
GET |
/v1/{version}/{book}/{chapter}/{verse} |
Single verse |
GET |
/v1/{version}/{book}/{chapter}/{start}-{end} |
Verse range |
GET |
/v1/votd |
Verse of the day (?language=&version=) |
A legacy flat API (same paths without the /v1 prefix) is kept frozen for
backward compatibility.
curl https://api.midvash.com/v1/versions
curl https://api.midvash.com/v1/kjv/john/3/16
curl "https://api.midvash.com/v1/kjv/john/3/16-18"
curl "https://api.midvash.com/v1/votd?language=en&version=kjv"Book slugs are in English (john, genesis, psalms).
npm install
npm run dev # local
npm run dev -- --remote # against the real R2 bucket
npm run typecheckA single Cloudflare Worker. All Bible content lives in an R2 bucket; the Cache API + Cloudflare cache rules absorb 99%+ of requests at the edge, so R2 is only read on a cold miss.
The version catalog (catalog/versions.json) is published to R2 by the
Midvash platform — this repo reads it at runtime and has
no other external dependency, so it builds and deploys entirely on its own.
MIT © Midvash
Part of Midvash — a free Bible reading & study platform. Everything is open and interlinks:
| 📖 Reader (web) | midvash.com — 9 languages |
| 📱 iOS app | midvash.app/ios |
| 🔌 API | api.midvash.com · bible-api |
| 🤖 MCP server | mcp.midvash.com · bible-mcp |
| 🧩 WordPress plugin | midvash.app/wordpress-plugin · bible-wordpress-plugin |
| 🧩 EmDash plugin | midvash.app/emdash-plugin · emdash-plugin-bible |
| 🌐 Chrome extension | midvash.app/chrome-extension · bible-chrome-extension |
| 📦 Open data | bible-data · bible-data-js · bible-cross-references |
Free & open, built by Midvash · midvash.com · midvash.app