Skip to content
HelloAOLabPublic

About

The Bible as an easy-to-use API.

Resources

Stars

162 stars

Watchers

10 watching

Forks

Repository files navigation

Free Use Bible API

A free JSON Bible API with over 1000 Bible translations in 700+ languages. No API keys, no rate limits, and no copyright restrictions — for personal, open source, or commercial use.

npm npm License: MIT

📖 Documentation · API Reference · SDKs

Quick Start

No signup, no key — just make an HTTP GET request:

curl https://bible.helloao.org/api/BSB/GEN/1.json

Or use the JavaScript/TypeScript client:

npm install free-use-bible-api
import { FreeUseBibleApi } from 'free-use-bible-api';

const api = new FreeUseBibleApi();

const available = await api.getAvailableTranslations();
console.log('Total translations:', available.translations.length);

const chapter = await api.getTranslationBookChapter('BSB', 'GEN', 1);
console.log('Verses in Genesis 1:', chapter.numberOfVerses);

Features

The Bible in JSON

Access over 1000 Bible translations in over 700 languages with an easy-to-use JSON format that also includes basic formatting information and additions like footnotes.

Free

No usage limits, no API Keys required, and no copyright restrictions whatsoever (including for modification or commercial uses). We only ask that if you change the content of a translation be sure to call it a different name to avoid confusion.

Globally Accessible

Hosted on the AWS network, the API is available anywhere in the world at low latencies.

What's Available

Resource Endpoint Description
Translations /api/{translation}/{book}/{chapter}.json Over 1000 Bible translations in more than 700 languages
Commentaries /api/c/{commentary}/{book}/{chapter}.json Public domain Bible commentaries, including Tyndale Open Resources
Datasets /api/d/{dataset}/{book}/{chapter}.json Supplementary data such as cross references

See the API Reference for every endpoint and its response types.

Downloads

Prefer to work offline? The whole API is available in bulk:

  • api.zip (1.5 GB) — the entire API as static JSON files
  • bible.db (11 GB) — every translation as a SQLite database
  • bible.eng.db (1.5 GB) — English translations only

Packages

Package Description
free-use-bible-api JavaScript/TypeScript client for the API
@helloao/cli CLI for generating and hosting your own Free Use Bible API
@helloao/tools Parsers and generators for USFM, USX, and Codex Bible formats

Our Inspiration

"Freely you have received; freely give." - Matthew 10:8

We believe the Bible should be freely available to everyone. Read more about a biblical model for licensing the Bible.

Get Started

See https://bible.helloao.org/docs/guide/ for instructions on using and accessing the API.

License

The API and this source code are available under the MIT license. The Berean Standard Bible and Majority Bible texts are dedicated to the public domain.

About Us

Made by AO Lab with ❤️

About

The Bible as an easy-to-use API.

Resources

Stars

162 stars

Watchers

10 watching

Forks

Releases

Packages

Used by

Contributors

Languages