The Bible
Welcome! This optional site exists to teach you all the available endpoints on API.Bible, and let you test out your API key. Feel free to use the navigation…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Welcome!
This optional site exists to teach you all the available endpoints on API.Bible, and let you test out your API key. Feel free to use the navigation on the left to explore available endpoints in API.Bible.
ⓘ Quick Tips
- If you've signed up, your API key is ready to use. Entering it on this page lets you test endpoints, nothing more. Enter your API key in the highlighted box, the one that says "value", to test endpoints in this site. In your own app, the key travels in an HTTP header _(api-key)_ with every request.
- API.Bible is a RESTful API. Every resource lives at a predictable URL, and you interact with it using standard HTTP verbs _(such as GET)_ and status codes.
- Responses come back as JSON, not raw verse text. You'll get structured data _(text plus metadata like IDs, references, and copyright)_ that your app reads and displays however you like.
- Status codes tell you what happened: 200 means it worked, 401 means a missing or bad key, 403 means you're not licensed for that resource, and 404 means the path is wrong.
- Not every Bible is available to every key. Access depends on your plan and agreement, so a request that looks correct can still come back denied if you're not licensed for that resource.
For a more general introduction to the API, including overviews on authentication, working with Bibles, handling errors, rate limiting, and more, our docs are a great resource. If you learn better by doing, view our demo app on Github.
Happy coding!
Endpoints 19
Bibles
- GETList Available Bibles
/biblesLists Bible objects authorized for the current API Key. This includes Creative Commons and Public Domain Bibles, as well as any Bibles licensed via a Starter… - GETGet a Bible
/bibles/:bibleIdGets a single Bible object using the given bibleId. A Bible object represents a single translation (NIV, ESV, etc.) of the Bible. Each Bible is accessible via…
Books
- GETList Books in a Bible
/bibles/:bibleId/booksLists Book objects for a given bibleId A Book object represents a single book (Matthew, Mark, etc.) of a single Bible. Each Book is accessible via a Book ID,… - GETGet a Book
/bibles/:bibleId/books/:bookIdGets a single Book object for a given bibleId and bookId. A Book object represents a single book (Matthew, Mark, etc.) of a single Bible. Each Book is…
Chapters
- GETList Chapters in a Book
/bibles/:bibleId/books/:bookId/chaptersLists Chapter objects for a given bibleId and bookId A Chapter object represents a single chapter of the Bible. Each Chapter is accessible via its Chapter ID,… - GETGet a Chapter
/bibles/:bibleId/chapters/:chapterIdGets a single Chapter object for a given bibleId and chapterId. A Chapter object represents a single chapter of the Bible. Each Chapter is accessible via its…
Passages
- GETGet a Passage
/bibles/:bibleId/passages/:passageIdGets a Passage object for a given bibleId and passageId. A Passage object represents an arbitrary range of verses from the Bible. These ranges are not…
Search
- GETSearch a Bible
/bibles/:bibleId/searchA search will attempt to match all verses with the list of keywords provided in the query string. The order of the keywords does not matter, however _all…
Sections
- GETList Sections in a Book
/bibles/:bibleId/books/:bookId/sectionsLists Section objects for a given bibleId and bookId A Section object represents a known range of verses in the Bible, typically tied to a story. Each Section… - GETList Sections in a Chapter
/bibles/:bibleId/chapters/:chapterId/sectionsLists Section objects for a given bibleId and chapterId Lists Section objects for a given bibleId and bookId A Section object represents a known range of… - GETGet a Section
/bibles/:bibleId/sections/:sectionIdGets a single Section object for a given bibleId and sectionId. Lists Section objects for a given bibleId and bookId A Section object represents a known range…
Verses
- GETList Verses in a Chapter
/bibles/:bibleId/chapters/:chapterId/versesLists Verse objects for a given bibleId and chapterId A Verse object represents a verse in the Bible. Each Verse is accessible via its Verse ID, a string… - GETGet a Verse
/bibles/:bibleId/verses/:verseIdGets a Verse object for a given bibleId and verseId. A Verse object represents a verse in the Bible. Each Verse is accessible via its Verse ID, a string…
Audio Bibles
- GETList Available Audio Bibles
/audio-biblesLists AudioBible objects authorized for current API Key. Audio Bibles are nearly identical to Bibles, including their content structure. Audio Bibles,… - GETGet an Audio Bible
/audio-bibles/:bibleIdGets a single AudioBible for a given bibleId An AudioBible object represents a single auditory translation (NIV, ESV, etc.) of the Bible. Each Bible is… - GETList Books in an Audio Bible
/audio-bibles/:bibleId/booksLists Book objects for a given bibleId A Book object represents a single book (Matthew, Mark, etc.) of a single Bible. Each Book is accessible via a Book ID,… - GETGet an Audio Book
/audio-bibles/:bibleId/books/:bookIdGets a single Book object for a given bibleId and bookId A Book object represents a single book (Matthew, Mark, etc.) of a single Bible. Each Book is… - GETList Audio Chapters in an Audio Book
/audio-bibles/:bibleId/books/:bookId/chaptersLists Chapter objects for a given bibleId and bookId A Chapter object represents a single chapter of the Bible. Each Chapter is accessible via its Chapter ID,… - GETGet an Audio Chapter
/audio-bibles/:bibleId/chapters/:chapterIdGets a single AudioChapter object for a given bible and chapterId. A presigned link to the mp3 audio file for this audio chapter will be included in the…
API details
- Base URL
https://rest.api.bible/{version}- Authentication
- An API key in the api-key header
- Operations
- 19 operations on 19 pathsGET 19
- Main resources
- Audio Bibles 6Sections 3Bibles 2Books 2Chapters 2Verses 2Passages 1Search 1
- Response formats
application/json- Description format
- OpenAPI 3.0.1, API version
1.6.3 - Links
- OpenAPI document · Terms of service
- Listed from
- Api Bible's published OpenAPI description
How to test the The Bible in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the The Bible collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the api-key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List Available Bibles” (GET /bibles), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the The Bible?
Welcome! This optional site exists to teach you all the available endpoints on API.Bible, and let you test out your API key. Feel free to use the navigation… It is listed under Media & content and has 19 endpoints.
Who publishes the The Bible?
It is listed from Api Bible's public API description (an OpenAPI document), not published by Api Bible on Swastik Codes. Anyone who controls api.bible can claim the profile by adding a DNS TXT record.
What is the base URL of the The Bible?
Requests go to https://rest.api.bible/{version}. Endpoint paths are added to this base URL.
How do I authenticate with the The Bible?
With an API key in the api-key header.
How many endpoints does the The Bible have?
19 operations on 19 paths (19 GET). The largest groups are Audio Bibles, Sections, Bibles, Books.
Is forking the The Bible free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.