Passage Audio Endpoint

Our passage audio endpoint, located at /v3/passage/audio/, provides an MP3 file of a given passage being read.

Example Request and Response

A simple request using cURL would look like this:

curl -L -H 'Authorization: Token {{ YOUR_KEY }}' 'https://api.esv.org/v3/passage/audio/?q=John+11:35' > audio.mp3

You will receive a redirect to an MP3 file. Be sure that your client follows redirects when using this endpoint.


Required Parameters

Name: q
Type: string
Default: ''

This is the requested passage. We try our best to parse a meaningful passage reference from this value. Here are some examples of what's accepted:

  • John 1:1
  • jn11.35
  • Genesis 1-3
  • 43011035
  • 01001001-01011032
  • John1.1;Genesis1.1
  • 19001001-19001006,19003001-19003008