{"openapi":"3.1.0","info":{"title":"Bible API","version":"1.0.0","description":"The Bible as an API. Fetch any verse or passage by reference — a single verse like John 3:16 or a range like Psalms 23:1-3 or Genesis 1:1-5 — and get the clean verse text, the individual verses with their book, chapter and verse numbers, and the translation name; pull a random verse for verse-of-the-day features; and list all available translations, including the World English Bible, King James Version, American Standard Version, Bible in Basic English, the Chinese Union Version and more. Live from bible-api.com. Ideal for Bible and devotional apps, church and ministry websites, verse-of-the-day widgets and study tools. Open scripture data.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bible-api","description":"oanor gateway"}],"tags":[{"name":"Bible"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Bible"],"summary":"A random verse","description":"","parameters":[{"name":"translation","in":"query","required":false,"description":"Translation id (default web)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"verse":{"book":"Joshua","text":"the king of Madon, one; the king of Hazor, one;","verse":19,"chapter":12,"reference":"Joshua 12:19","translation":"World English Bible"}},"meta":{"timestamp":"2026-05-31T15:47:04.938Z","request_id":"7bab2ae7-9f7b-4eb0-b9a2-778e37e25311"},"status":"ok","message":"Random verse retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/translations":{"get":{"operationId":"get_v1_translations","tags":["Bible"],"summary":"Available translations","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":17,"translations":[{"id":"cherokee","name":"Cherokee New Testament","license":"Public Domain","language":"Cherokee","language_code":"chr"},{"id":"cuv","name":"Chinese Union Version","license":"Public Domain","language":"Chinese","language_code":"zh-tw"},{"id":"bkr","name":"Bible kralická","license":"Public Domain","language":"Czech","language_code":"cze"},{"id":"asv","name":"American Standard Version (1901)","license":"Public Domain","language":"English","language_code":"eng"},{"id":"bbe","name":"Bible in Basic English","license":"Public Domain","language":"English","language_code":"eng"},{"id":"darby","name":"Darby Bible","license":"Public Domain","language":"English","language_code":"eng"},{"id":"dra","name":"Douay-Rheims 1899 American Edition","license":"Public Domain","language":"English","language_code":"eng"},{"id":"kjv","name":"King James Version","license":"Public Domain","language":"English","language_code":"eng"},{"id":"web","name":"World English Bible","license":"Public Domain","language":"English","language_code":"eng"},{"id":"ylt","name":"Young's Literal Translation (NT only)","license":"Public Domain","language":"English","language_code":"eng"},{"id":"oeb-cw","name":"Open English Bible, Commonwealth Edition","license":"Public Domain","language":"English (UK)","language_code":"eng"},{"id":"webbe","name":"World English Bible, British Edition","license":"Public Domain","language":"English (UK)","language_code":"eng"},{"id":"oeb-us","name":"Open English Bible, US Edition","license":"Public Domain","language":"English (US)","language_code":"eng"},{"id":"clementine","name":"Clementine Latin Vulgate","license":"Public Domain","language":"Latin","language_code":"lat"},{"id":"almeida","name":"João Ferreira de Almeida","license":"Public Domain","language":"Portuguese","language_code":"por"},{"id":"rccv","name":"Protestant Romanian Corrected Cornilescu Version","license":"Public Domain","language":"Romanian","language_code":"ron"},{"id":"synodal","name":"Russian Synodal Translation","license":"Public Domain","language":"Russian","language_code":"rus"}]},"meta":{"timestamp":"2026-05-31T15:47:05.130Z","request_id":"31eaac75-23c4-4551-a78b-cdf707f33ea1"},"status":"ok","message":"Translations retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/verse":{"get":{"operationId":"get_v1_verse","tags":["Bible"],"summary":"A verse or passage","description":"","parameters":[{"name":"reference","in":"query","required":true,"description":"Verse or passage, e.g. John 3:16 or Psalms 23:1-3","schema":{"type":"string"},"example":"John 3:16"},{"name":"translation","in":"query","required":false,"description":"Translation id (default web)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"passage":{"text":"For God so loved the world, that he gave his one and only Son, that whoever believes in him should not perish, but have eternal life.","verses":[{"book":"John","text":"For God so loved the world, that he gave his one and only Son, that whoever believes in him should not perish, but have eternal life.","verse":16,"chapter":3}],"reference":"John 3:16","translation":"World English Bible","verse_count":1,"translation_id":"web"}},"meta":{"timestamp":"2026-05-31T15:47:05.324Z","request_id":"18f6121a-1238-47e8-8558-7cbf53d559a5"},"status":"ok","message":"Verse retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & options","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Bible scripture. /v1/verse = a verse or passage by reference (e.g. John 3:16, Psalms 23:1-3, Genesis 1:1-5) in a chosen translation; /v1/random = a random verse; /v1/translations = the available translations (WEB, KJV, ASV, BBE, Cherokee, Chinese Union and more). Default translation is 'web'.","source":"bible-api.com","endpoints":["/v1/verse","/v1/random","/v1/translations","/v1/meta"],"default_translation":"web (World English Bible)"},"meta":{"timestamp":"2026-05-31T15:47:05.403Z","request_id":"dbfa6f0d-2909-4b36-8074-4b71958137c7"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":4200,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":345,"monthly_call_quota":58000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1055,"monthly_call_quota":300000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2815,"monthly_call_quota":1480000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bible-api"}