ESV API Overview

The ESV API provides access to the ESV text, with a customizable presentation in multiple formats. You will need an HTTP client in your programming language of choice to use the API.

To obtain an API key, you will first need to create an API Application.


When making requests, you will need to include your application's key with each request in the Authorization header like this:

Authorization: Token YOUR_API_KEY


We provide the following API endpoints:

These endpoints support many optional parameters, but q (your passage query) is the only one that's required.

Sample Projects

We've created a few sample projects to help you get started with our API. Each is implemented in Python 3 and intended to be run on the command line.

See our API Sample Projects page for details.