The public preview contract for ScriptureFlow's runtime lookup endpoints and\ngenerated static JSON resources. Discover exact, case-sensitive version keys\nthrough /translations.json; version keys are machine identifiers such as\nen-kjv, not display labels such as kjv or en-KJV.
The preview currently requires no authentication. Scripture translation\nlicensing and attribution requirements remain applicable to API consumers.
\nContact Support:\n Name: ScriptureFlow
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"1355224","collectionId":"56ff74c9-41a8-43ee-906a-bf5ccce24da6","publishedId":"2sBXwvJoj6","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-06-20T09:19:25.000Z"},"item":[{"name":"status.json","item":[{"name":"Get public build status","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 200', function () {"," pm.response.to.have.status(200);","})","","pm.test('Response is JSON', function () {"," pm.response.to.be.json;","})","","pm.test('Response time is under 3000ms', function () {"," pm.expect(pm.response.responseTime).to.be.below(3000);","})","","pm.test('Has required Status fields', function () {"," const json = pm.response.json();"," pm.expect(json).to.have.property('generated_at').that.is.a('string');"," pm.expect(json).to.have.property('total_discovered').that.is.a('number');"," pm.expect(json).to.have.property('total_ready').that.is.a('number');"," pm.expect(json).to.have.property('total_warning').that.is.a('number');"," pm.expect(json).to.have.property('total_failed').that.is.a('number');"," pm.expect(json).to.have.property('split_indexes').that.is.a('number');"," pm.expect(json).to.have.property('split_index_translations').that.is.an('array');"," pm.expect(json).to.have.property('failed').that.is.an('array');","})","","pm.test('generated_at is a valid ISO 8601 date-time', function () {"," const json = pm.response.json();"," pm.expect(new Date(json.generated_at).toString()).to.not.equal('Invalid Date');","})","","pm.test('total_ready is greater than or equal to 0', function () {"," const json = pm.response.json();"," pm.expect(json.total_ready).to.be.at.least(0);","})","","pm.test('[Smoke] Status code is 200', function () {"," pm.response.to.have.status(200);","})","","pm.test('[Smoke] Content-Type is JSON', function () {"," pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');","})","","pm.test('[Smoke] Response time is under 3000ms', function () {"," pm.expect(pm.response.responseTime).to.be.below(3000);","})","","pm.test('[Smoke] Body has \"status\" field (string)', function () {"," pm.expect(jsonData).to.have.property('status');"," pm.expect(jsonData.status).to.be.a('string');","})","","pm.test('[Smoke] Body has \"last_updated\" field (string, ISO 8601)', function () {"," pm.expect(jsonData).to.have.property('last_updated');"," pm.expect(jsonData.last_updated).to.be.a('string');"," pm.expect(jsonData.last_updated).to.match(/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}/);","})","","pm.test('[Smoke] Body has \"total_ready\" field (number >= 0)', function () {"," pm.expect(jsonData).to.have.property('total_ready');"," pm.expect(jsonData.total_ready).to.be.a('number');"," pm.expect(jsonData.total_ready).to.be.at.least(0);","})"]}}],"id":"3cbd5479-0f39-4e52-9d8d-411d2920807d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://scriptureflow-api-preview.pages.dev/status.json","urlObject":{"path":["status.json"],"host":["https://scriptureflow-api-preview.pages.dev"],"query":[],"variable":[]}},"response":[{"id":"0641a5a1-242f-459f-962f-c68fe1535080","name":"Current generated API build status.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://scriptureflow-api-preview.pages.dev/status.json"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"generated_at\": \"1983-04-01T09:03:16.102Z\",\n \"total_discovered\": 8356,\n \"total_ready\": 7184,\n \"total_warning\": 3525,\n \"total_failed\": 6101,\n \"split_indexes\": 816,\n \"split_index_translations\": [\n {\n \"version\": \"string\",\n \"part_count\": 123,\n \"largest_part_bytes\": 2561\n },\n {\n \"version\": \"string\",\n \"part_count\": 4118,\n \"largest_part_bytes\": 1256\n }\n ],\n \"failed\": [\n {\n \"version\": \"string\",\n \"failures\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"version\": \"string\",\n \"failures\": [\n \"string\",\n \"string\"\n ]\n }\n ]\n}"},{"id":"316df50f-fc8d-430f-b5ec-d49f50a5e4d7","name":"The generated resource or version was not found. Static-host responses may not use the runtime `ErrorResponse` envelope.","originalRequest":{"method":"GET","header":[],"url":"https://scriptureflow-api-preview.pages.dev/status.json"},"status":"Not Found","code":404,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"3cbd5479-0f39-4e52-9d8d-411d2920807d"}],"id":"a19dadad-af3f-4e3d-99b8-485a80075d6e","_postman_id":"a19dadad-af3f-4e3d-99b8-485a80075d6e","description":""},{"name":"translations.json","item":[{"name":"List published translation version keys","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 200', function () {"," pm.response.to.have.status(200);","})","","pm.test('Response is JSON', function () {"," pm.response.to.be.json;","})","","pm.test('Response time is under 3000ms', function () {"," pm.expect(pm.response.responseTime).to.be.below(3000);","})","","pm.test('Response is a non-empty array', function () {"," const json = pm.response.json();"," pm.expect(json).to.be.an('array').that.is.not.empty;","})","","pm.test('Each translation has required fields', function () {"," const json = pm.response.json();"," json.forEach(function (item) {"," pm.expect(item).to.have.property('version').that.is.a('string');"," pm.expect(item).to.have.property('language_code').that.is.a('string');"," pm.expect(item).to.have.property('translation_name').that.is.a('string');"," pm.expect(item).to.have.property('status').that.is.a('string');"," pm.expect(item).to.have.property('books_found').that.is.a('number');"," pm.expect(item).to.have.property('chapters_found').that.is.a('number');"," pm.expect(item).to.have.property('verses_found').that.is.a('number');"," });","})","","pm.test('Version keys match expected pattern (e.g. en-kjv)', function () {"," const json = pm.response.json();"," json.forEach(function (item) {"," pm.expect(item.version).to.match(/^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)+$/);"," });","})","","pm.test('Store first version key as environment variable', function () {"," const json = pm.response.json();"," if (json.length > 0) {"," pm.environment.set('version', json[0].version);"," }","})","","pm.test('[Smoke] Status code is 200', function () {"," pm.response.to.have.status(200);","})","","pm.test('[Smoke] Content-Type is JSON', function () {"," pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');","})","","pm.test('[Smoke] Response time is under 3000ms', function () {"," pm.expect(pm.response.responseTime).to.be.below(3000);","})","","pm.test('[Smoke] Body is a non-empty array', function () {"," pm.expect(jsonData).to.be.an('array').that.is.not.empty;","})","","pm.test('[Smoke] Each item is a string', function () {"," jsonData.forEach(function (item) {"," pm.expect(item).to.be.a('string');"," });","})","","pm.test('[Smoke] Each item matches version key pattern (e.g. en-kjv)', function () {"," jsonData.forEach(function (item) {"," pm.expect(item).to.match(/^[a-z]{2}-[a-z]+$/i);"," });","})"]}}],"id":"94d016a8-d5ca-4d1f-9325-b0e3feb20953","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://scriptureflow-api-preview.pages.dev/translations.json","description":"Use the exact version value returned here in all translation-scoped requests.
Exact, case-sensitive machine identifier from /translations.json (for example en-kjv, not kjv or en-KJV).
Exact, case-sensitive machine identifier from /translations.json (for example en-kjv, not kjv or en-KJV).
Exact, case-sensitive machine identifier from /translations.json (for example en-kjv, not kjv or en-KJV).
Small indexes are returned as a JSON array. Large indexes are returned as\na split-index manifest whose parts point to generated part files. Most\nclients should use the runtime lookup endpoints instead of loading an\nentire index.
Exact, case-sensitive machine identifier from /translations.json (for example en-kjv, not kjv or en-KJV).
Returns a stable generated verse for the translation. This is not a live\nrandom endpoint. Use /api/quick-verse when refreshing should select a\nnew runtime-random verse.
Exact, case-sensitive machine identifier from /translations.json (for example en-kjv, not kjv or en-KJV).
Supply version plus either a free-text reference, or structured\nbook, chapter, and verse/start_verse fields. A non-empty\nreference takes priority over structured lookup fields. start_verse\nis an alias for verse and takes priority over it when both are present.\nend_verse creates an inclusive, same-chapter range. Cross-chapter ranges\nare not supported.
Exact machine identifier from /translations.json (for example en-kjv, not kjv or en-KJV).
Free-text reference such as John 3:16 or Amos 8:4-6; takes priority when present.
Book name, slug, or supported alias for structured lookup.
\n","type":"text/plain"},"key":"book","value":"John"},{"description":{"content":"Chapter number for structured lookup.
\n","type":"text/plain"},"key":"chapter","value":"3"},{"description":{"content":"Starting verse for structured lookup. Used unless start_verse is present.
Alias for verse; takes priority over verse when both are supplied.
Inclusive end of a same-chapter range, at most 50 verses including the start.
\n","type":"text/plain"},"key":"end_verse","value":"100"}],"variable":[]}},"response":[{"id":"979ec65b-7607-4a44-af9c-6b478b874b35","name":"A single verse or inclusive same-chapter passage.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://scriptureflow-api-preview.pages.dev/api/verse?version=en-kjv&reference=John 3:16&book=John&chapter=3&verse=16&start_verse=100&end_verse=100","host":["https://scriptureflow-api-preview.pages.dev"],"path":["api","verse"],"query":[{"description":"Exact machine identifier from `/translations.json` (for example `en-kjv`, not `kjv` or `en-KJV`).","key":"version","value":"en-kjv"},{"description":"Free-text reference such as `John 3:16` or `Amos 8:4-6`; takes priority when present.","key":"reference","value":"John 3:16"},{"description":"Book name, slug, or supported alias for structured lookup.","key":"book","value":"John"},{"description":"Chapter number for structured lookup.","key":"chapter","value":"3"},{"description":"Starting verse for structured lookup. Used unless `start_verse` is present.","key":"verse","value":"16"},{"description":"Alias for `verse`; takes priority over `verse` when both are supplied.","key":"start_verse","value":"100"},{"description":"Inclusive end of a same-chapter range, at most 50 verses including the start.","key":"end_verse","value":"100"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"ok\": true,\n \"type\": \"verse_lookup\",\n \"version\": \"en-kjv\",\n \"reference\": \"John 3:16\",\n \"book\": \"john\",\n \"chapter\": 3,\n \"verse\": 16,\n \"text\": \"For God so loved the world...\",\n \"served_at_utc\": \"2026-06-20T07:14:53.528Z\",\n \"query\": {\n \"version\": \"en-kjv\",\n \"book\": \"John\",\n \"canonical_book\": \"john\",\n \"chapter\": 3,\n \"verse\": 16\n },\n \"result\": {\n \"id\": \"en-kjv:john:3:16\",\n \"version\": \"en-kjv\",\n \"book\": \"john\",\n \"book_slug\": \"john\",\n \"canonical_book\": \"john\",\n \"chapter\": 3,\n \"verse\": 16,\n \"reference\": \"John 3:16\",\n \"text\": \"For God so loved the world...\",\n \"source_path\": \"bibles/en-kjv/books/john/chapters/3/verses/16.json\",\n \"api_path\": \"/en-kjv/books/john/chapters/3/verses/16.json\"\n },\n \"source\": {\n \"method\": \"book-asset\",\n \"index\": \"/en-kjv/books/john.json\",\n \"api_path\": \"/en-kjv/books/john/chapters/3/verses/16.json\",\n \"source_path\": \"bibles/en-kjv/books/john/chapters/3/verses/16.json\",\n \"source_text_origin\": \"book_asset\"\n },\n \"behavior\": {\n \"selection\": \"requested_reference\",\n \"refresh_returns_new_verse\": false,\n \"runtime_lookup\": true,\n \"static_generated\": false\n },\n \"lookup\": {\n \"method\": \"book-asset\"\n }\n}"},{"id":"f9a7f80e-b010-450d-98d3-907bdf149490","name":"Invalid query, reference, version, or numeric range.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://scriptureflow-api-preview.pages.dev/api/verse?version=en-kjv&reference=John 3:16&book=John&chapter=3&verse=16&start_verse=100&end_verse=100","host":["https://scriptureflow-api-preview.pages.dev"],"path":["api","verse"],"query":[{"description":"Exact machine identifier from `/translations.json` (for example `en-kjv`, not `kjv` or `en-KJV`).","key":"version","value":"en-kjv"},{"description":"Free-text reference such as `John 3:16` or `Amos 8:4-6`; takes priority when present.","key":"reference","value":"John 3:16"},{"description":"Book name, slug, or supported alias for structured lookup.","key":"book","value":"John"},{"description":"Chapter number for structured lookup.","key":"chapter","value":"3"},{"description":"Starting verse for structured lookup. Used unless `start_verse` is present.","key":"verse","value":"16"},{"description":"Alias for `verse`; takes priority over `verse` when both are supplied.","key":"start_verse","value":"100"},{"description":"Inclusive end of a same-chapter range, at most 50 verses including the start.","key":"end_verse","value":"100"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"ok\": false,\n \"type\": \"verse_lookup\",\n \"error_code\": \"INVALID_VERSION\",\n \"error\": \"Invalid version. Use a published ScriptureFlow version key such as en-lsv.\",\n \"query\": {\n \"version\": \"../secret\"\n }\n}"},{"id":"dbc86d59-1e9f-4044-a281-835a71c1771f","name":"Translation book asset or one or more requested verses were not found.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://scriptureflow-api-preview.pages.dev/api/verse?version=en-kjv&reference=John 3:16&book=John&chapter=3&verse=16&start_verse=100&end_verse=100","host":["https://scriptureflow-api-preview.pages.dev"],"path":["api","verse"],"query":[{"description":"Exact machine identifier from `/translations.json` (for example `en-kjv`, not `kjv` or `en-KJV`).","key":"version","value":"en-kjv"},{"description":"Free-text reference such as `John 3:16` or `Amos 8:4-6`; takes priority when present.","key":"reference","value":"John 3:16"},{"description":"Book name, slug, or supported alias for structured lookup.","key":"book","value":"John"},{"description":"Chapter number for structured lookup.","key":"chapter","value":"3"},{"description":"Starting verse for structured lookup. Used unless `start_verse` is present.","key":"verse","value":"16"},{"description":"Alias for `verse`; takes priority over `verse` when both are supplied.","key":"start_verse","value":"100"},{"description":"Inclusive end of a same-chapter range, at most 50 verses including the start.","key":"end_verse","value":"100"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"ok\": false,\n \"type\": \"verse_lookup\",\n \"error_code\": \"BOOK_ASSET_NOT_FOUND\",\n \"error\": \"Book lookup asset not found\",\n \"query\": {\n \"version\": \"en-lsv\",\n \"book\": \"Unknown\",\n \"chapter\": 1,\n \"verse\": 1\n }\n}"},{"id":"2cc978c1-e964-43cd-b037-ed94517ea06e","name":"Required canonical book metadata was unavailable.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://scriptureflow-api-preview.pages.dev/api/verse?version=en-kjv&reference=John 3:16&book=John&chapter=3&verse=16&start_verse=100&end_verse=100","host":["https://scriptureflow-api-preview.pages.dev"],"path":["api","verse"],"query":[{"description":"Exact machine identifier from `/translations.json` (for example `en-kjv`, not `kjv` or `en-KJV`).","key":"version","value":"en-kjv"},{"description":"Free-text reference such as `John 3:16` or `Amos 8:4-6`; takes priority when present.","key":"reference","value":"John 3:16"},{"description":"Book name, slug, or supported alias for structured lookup.","key":"book","value":"John"},{"description":"Chapter number for structured lookup.","key":"chapter","value":"3"},{"description":"Starting verse for structured lookup. Used unless `start_verse` is present.","key":"verse","value":"16"},{"description":"Alias for `verse`; takes priority over `verse` when both are supplied.","key":"start_verse","value":"100"},{"description":"Inclusive end of a same-chapter range, at most 50 verses including the start.","key":"end_verse","value":"100"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"ok\": false,\n \"type\": \"verse_lookup\",\n \"error_code\": \"CANONICAL_BOOK_MAP_UNAVAILABLE\",\n \"error\": \"Canonical book map not available\"\n}"}],"_postman_id":"e9688c7d-80b5-459d-aa55-4f220e8b5cc7"}],"id":"194e4fbf-5090-45b1-9e4f-bf66a3456ead","_postman_id":"194e4fbf-5090-45b1-9e4f-bf66a3456ead","description":""},{"name":"quick-verse","item":[{"name":"Get a runtime-selected random verse","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Status 200', function () {"," pm.response.to.have.status(200);","})","","pm.test('Response is JSON', function () {"," pm.response.to.be.json;","})","","pm.test('Response time is under 3000ms', function () {"," pm.expect(pm.response.responseTime).to.be.below(3000);","})","","pm.test('ok is true', function () {"," const json = pm.response.json();"," pm.expect(json.ok).to.be.true;","})","","pm.test('type is quick_verse', function () {"," const json = pm.response.json();"," pm.expect(json.type).to.equal('quick_verse');","})","","pm.test('Has required QuickVerseResponse fields', function () {"," const json = pm.response.json();"," pm.expect(json).to.have.property('version').that.is.a('string');"," pm.expect(json).to.have.property('reference').that.is.a('string');"," pm.expect(json).to.have.property('book').that.is.a('string');"," pm.expect(json).to.have.property('chapter').that.is.a('number');"," pm.expect(json).to.have.property('verse').that.is.a('number');"," pm.expect(json).to.have.property('text').that.is.a('string');"," pm.expect(json).to.have.property('served_at_utc').that.is.a('string');"," pm.expect(json).to.have.property('result').that.is.an('object');"," pm.expect(json).to.have.property('behavior').that.is.an('object');"," pm.expect(json).to.have.property('source').that.is.an('object');","})","","pm.test('behavior.refresh_returns_new_verse is true', function () {"," const json = pm.response.json();"," pm.expect(json.behavior.refresh_returns_new_verse).to.be.true;","})","","pm.test('Cache-Control header is no-store', function () {"," pm.expect(pm.response.headers.get('Cache-Control')).to.equal('no-store');","})","","pm.test('served_at_utc is a valid ISO 8601 date-time', function () {"," const json = pm.response.json();"," pm.expect(new Date(json.served_at_utc).toString()).to.not.equal('Invalid Date');","})","","pm.test('result has id, version, book, chapter, verse, text', function () {"," const json = pm.response.json();"," const r = json.result;"," pm.expect(r).to.have.property('id').that.is.a('string');"," pm.expect(r).to.have.property('version').that.is.a('string');"," pm.expect(r).to.have.property('book').that.is.a('string');"," pm.expect(r).to.have.property('chapter').that.is.a('number');"," pm.expect(r).to.have.property('verse').that.is.a('number');"," pm.expect(r).to.have.property('text').that.is.a('string');","})","","pm.test('[Smoke] Status code is 200', function () {"," pm.response.to.have.status(200);","})","","pm.test('[Smoke] Content-Type is JSON', function () {"," pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');","})","","pm.test('[Smoke] Response time is under 3000ms', function () {"," pm.expect(pm.response.responseTime).to.be.below(3000);","})","","pm.test('[Smoke] Body has \"ok\" field (boolean true)', function () {"," pm.expect(jsonData).to.have.property('ok');"," pm.expect(jsonData.ok).to.be.true;","})","","pm.test('[Smoke] Body has \"type\" field equal to \"quick_verse\"', function () {"," pm.expect(jsonData).to.have.property('type').that.is.a('string');"," pm.expect(jsonData.type).to.equal('quick_verse');","})","","pm.test('[Smoke] Body has \"result\" field (object)', function () {"," pm.expect(jsonData).to.have.property('result').that.is.an('object');","})","","pm.test('[Smoke] result.book is a string', function () {"," pm.expect(jsonData.result).to.have.property('book').that.is.a('string');","})","","pm.test('[Smoke] result.chapter is a number >= 1', function () {"," pm.expect(jsonData.result).to.have.property('chapter').that.is.a('number');"," pm.expect(jsonData.result.chapter).to.be.at.least(1);","})","","pm.test('[Smoke] result.verse is a number >= 1', function () {"," pm.expect(jsonData.result).to.have.property('verse').that.is.a('number');"," pm.expect(jsonData.result.verse).to.be.at.least(1);","})","","pm.test('[Smoke] result.text is a non-empty string', function () {"," pm.expect(jsonData.result).to.have.property('text').that.is.a('string');"," pm.expect(jsonData.result.text.trim().length).to.be.at.least(1);","})","","pm.test('[Smoke] Body has \"served_at_utc\" field (string)', function () {"," pm.expect(jsonData).to.have.property('served_at_utc').that.is.a('string');","})","","pm.test('[Smoke] Cache-Control header contains \"no-store\"', function () {"," const cacheControl = pm.response.headers.get('Cache-Control') || '';"," pm.expect(cacheControl).to.include('no-store');","})"]}}],"id":"0e3ae04a-e8bf-4f6e-9b17-7433ebddc921","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://scriptureflow-api-preview.pages.dev/api/quick-verse?version=en-kjv","description":"Selects a verse at request time from the requested translation. Refreshing\nmay return a different verse. This is distinct from the stable generated\n/{version}/random.json Verse of the Day. Internally, the endpoint can use\neither a single verse index or a split-index manifest. Responses currently\nuse Cache-Control: no-store.
Exact machine identifier from /translations.json (for example en-kjv, not kjv or en-KJV).