# API.Bible

> API.Bible is a REST API providing programmatic access to Bible texts, verses, chapters, search, and metadata across hundreds of Bible versions and languages. This developer portal lets developers register, obtain API keys, browse available Bibles, and read the API reference.

The canonical machine-readable specification is the OpenAPI/Swagger document — prefer it over prose when generating integration code. The full conceptual documentation lives at docs.api.bible.

## API reference

- [OpenAPI specification](https://rest.api.bible/v1/swagger.json): Machine-readable OpenAPI/Swagger spec for the v1 REST API. Source of truth for endpoints, parameters, request/response schemas, and the API base URL (`https://rest.api.bible`).
- [Interactive API reference](https://api.bible/api-reference): Browsable reference rendered from the OpenAPI spec.
- [Full documentation](https://docs.api.bible): Conceptual guides, including authentication and quick-start.
- [Authentication quick start](https://docs.api.bible/quick-start/authentication/): How to authenticate requests using an API key.

## Getting started

- [Getting Started](https://api.bible/getting-started): Step-by-step guide to making your first API.Bible request.
- [API Key Guide](https://api.bible/api-key-guide): How to obtain and use an API key.
- [Available Bibles](https://api.bible/bibles): Browse the Bible versions and languages available through the API.
- [FAQ](https://api.bible/faq): Frequently asked questions about access, usage, and licensing.

## SDKs and demo app

- [JavaScript/TypeScript SDK](https://www.npmjs.com/package/@americanbible/api-bible-sdk): Official `@americanbible/api-bible-sdk` npm package for calling the API.Bible REST API from JavaScript and TypeScript.
- [Live Demo App](https://demo.api.bible): Hosted demo application showcasing common API.Bible integration patterns.
- [Demo App source](https://github.com/americanbible/api-bible-demo): Cloneable reference implementation demonstrating API.Bible requests within a real codebase.
- [TypeScript SDK Announcement](https://api.bible/sdk): Official announcement for the `@americanbible/api-bible-sdk` npm package.

## Partner (IP holder) landing pages

- [Partner Organizations](https://api.bible/partners): Overview of the publishers and rights holders whose translations are available through API.Bible.
- [HarperCollins + API.Bible](https://api.bible/partners/harpercollins): HarperCollins Christian Publishing (Thomas Nelson, Zondervan) partner page.
- [Biblica + API.Bible](https://api.bible/partners/biblica): Biblica (New International Version) partner page.
- [Tyndale + API.Bible](https://api.bible/partners/tyndale): Tyndale House (New Living Translation) partner page.
- [Lifeway + API.Bible](https://api.bible/partners/lifeway): Lifeway Holman (Christian Standard Bible) partner page.
- [Lockman + API.Bible](https://api.bible/partners/lockman): The Lockman Foundation (NASB, Amplified Bible) partner page.

## Optional

- [About](https://api.bible/about): Background on the API.Bible project.
- [Partners](https://api.bible/partners): Organizations partnering with API.Bible.
- [Terms and Conditions](https://api.bible/terms-and-conditions): Terms governing use of the API and portal.