Skip to main content

getBible Json API V2

api.getbible.net

This main API endpoint is used to retrieve a complete translation, book, or chapter from the Bible.

query.getbible.net

This Query endpoint is used to retrieve a combination of individual/grouped verses from multiple books and chapters in one translation.

QUERY API for individual/grouped verses

Together with our new release of the GetBible API V2 we are very excited to announce the release of the grouped verse Query API.

The QUERY API is now hosted on https://query.getbible.net/v2/kjv/1 John 3:16.

Why the Query API?

  • Grouped Verses: Select specific verse groupings for targeted scriptural insights.
  • Multi-Chapter Retrieval: Gather verses from a variety of chapters in one go.
  • Single Translation Focus: Query verses from one Bible translation at a time.
  • Performance Optimized: Fast and reliable responses, even for comprehensive queries.
  • Simple Integration: Easy to implement with clear documentation, allowing for quick deployment in any project.

Query API Usage

The design allows for one translation at a time:

https://query.getbible.net/v2/[translation]/[references]

But with multiple scripture references:

https://query.getbible.net/v2/kjv/John 3:16; 1 John 3:16; John 1:1

The book name or book number must be in each reference.

More details

Give attention to spaces.

There can be spaces or not between the book name and chapter, as well as before the book name if it has a number like this:

https://query.getbible.net/v2/kjv/1John3:16-19

or this

https://query.getbible.net/v2/kjv/1 John 3:16-19

But when using the book number to reference the Bible book name, spaces are required:

https://query.getbible.net/v2/kjv/62 3:16-19

When quering multiple references: After semicolons spaces are optional:

https://query.getbible.net/v2/kjv/John3:16,17;1John3:16-19,22


Remember: The verses you queried will return in the order of your query, even of the verses within a chapter.

https://query.getbible.net/v2/kjv/John 3:6; Genesis 1:27;John 1:3,2

Book Names

Use the book names found in the translation book list.

Each translation has its own book list as shown in the MAPPING HELPER area.

Building queries with those names will work for each translation

As a default all the book names for the KJV works for all translations.

Examples:


Ancient Hebrew Books (OWN-NAMES):

https://query.getbible.net/v2/codex/בְּרֵאשִׁית 1:26

Ancient Hebrew Books (KJV-NAMES):

https://query.getbible.net/v2/codex/Genesis 1:26


Afrikaans Books (OWN-NAMES):

https://query.getbible.net/v2/aov/Johannes 3:16-19;1 Johannes 3:16-19,22

Afrikaans Books (KJV-NAMES):

https://query.getbible.net/v2/aov/John 3:16-19;1 John 3:16-19,22

Restrictions

When you want a whole chapter or book this query API is not for you, use the Main API as explained below.

Like this: https://api.getbible.net/v2/kjv/66/3.json

Main API for complete translation, book, or chapter

The GetBible API is a robust and flexible interface designed to provide comprehensive access to many translations of the Bible. With the GetBible API, users can retrieve various portions of the Bible with ease, making it an ideal resource for developers, content creators, and educators who need full-scope access to biblical texts for their projects and platforms.

The MAIN API is hosted on https://api.getbible.net/v2/kjv/62/3.json.

Why the Main API?

  • Complete Translation Retrieval: Retrive a whole translation at once.
  • Complete Book Retrieval: Retrieve a whole book in a selected translation at once.
  • Complete Chapter Retrieval: Retrieve a whole chapter of a selected book and translation at once.
  • Bulk Retrieval: This endpoint is made for fast bulk retrieval of the scripture.

Main API Usage

The design allows for one translation-book-chapter at a time:

  • https://api.getbible.net/v2/[translation].json
  • https://api.getbible.net/v2/[translation]/[book_number].json
  • https://api.getbible.net/v2/[translation]/[book_number]/[chapter_number].json

Restrictions

When you want selected verses of a chapter this API is not what you are looking for, use the query API as explained above

Like this: https://query.getbible.net/v2/kjv/John 3:16,17; 1 John 3:16-19,22

Mapping Helpers

To help users interact with our API, we have added mapping helpers. These helpers will inform you of any changes via a hash for various parts of the scripture, validate downloads, inform you of each translation's scope of the Holy Scripture, and other useful information.

We continue our journey to keep the integrity of the Holy Scripture and provide the most accurate text to all users. If you have any questions or need further clarification, please feel free to open issues in the relevant repositories, and we'll respond as soon as we can.

Join the GetBible journey - Get involved and share the Word
until everyone has heard

If you are still using the old API please note its end-of-life was end of 2021 and you should move over to the new v2 API.

See details of archived version 1 of GetBible at:

https://getbible.net/archived

API Versions Road Map

1.0 1.0.0 2.0.0 3.0.0 Stable Release Security Release Stable Release Security Release Stable Release Security Release Alpha Release Beta Release Stable Release Security Release 1 Jan 2015 1 Jan 2016 1 Jan 2017 1 Jan 2018 1 Jan 2019 1 Jan 2020 1 Jan 2021 1 Jan 2022 1 Jan 2023 1 Jan 2024 1 Jan 2025 1 Jan 2026 1 Jan 2027 1 Jan 2028 1 Jan 2029 1 Jan 2030 1 Jan 2031 Today: 8 Oct 2024
Future Releases
Stable Release
Security Release
Alpha Release
Beta Release
Version at End of Life
Lord Willing!