ESV Bible Web Service

Upgrade Guide from Version 1 API

Your old key will work on the new server, but you now get 5,000 requests per day instead of 500.

The default audio-format is flash instead of real.

SOAP support has been removed.

URLs have changed slightly:

Previous URL New URL
http://www.gnpcb.org/esv/share/get/ ?action=doPassageQuery http://www.esvapi.org/v2/rest/passageQuery
http://www.gnpcb.org/esv/share/get/ ?action=doQuery http://www.esvapi.org/v2/rest/query
http://www.gnpcb.org/esv/share/get/ ?action=doReadingPlanQuery http://www.esvapi.org/v2/rest/readingPlanQuery
http://www.gnpcb.org/esv/share/get/ ?action=getQueryInfo http://www.esvapi.org/v2/rest/queryInfo
http://www.gnpcb.org/esv/share/get/ ?action=getReadingPlanInfo http://www.esvapi.org/v2/rest/readingPlanInfo
http://www.gnpcb.org/esv/share/get/ ?action=getVerse http://www.esvapi.org/v2/rest/verse
http://www.gnpcb.org/esv/share/get/ ?action=getDailyVerse http://www.esvapi.org/v2/rest/dailyVerse

In other words, the action parameter no longer exists; its former value is now part of the request path. In addition, the former action values no longer include verbs.

All other parameters are the same. Here are some examples of old and new queries:

Previous URL New URL
http://www.gnpcb.org/esv/share/get/ ?action=doPassageQuery&key=IP &passage=jn+1&include-headings=false http://www.esvapi.org/v2/rest/passageQuery ?key=IP&passage=jn+1&include-headings=false
http://www.gnpcb.org/esv/share/get/ ?action=doQuery&key=IP&q=love http://www.esvapi.org/v2/rest/query ?key=IP&q=love
http://www.gnpcb.org/esv/share/get/ ?action=doReadingPlanQuery&key=IP &reading-plan=bcp http://www.esvapi.org/v2/rest/readingPlanQuery ?key=IP&reading-plan=bcp
http://www.gnpcb.org/esv/share/get/ ?action=getQueryInfo&key=IP &q=Matthew http://www.esvapi.org/v2/rest/queryInfo ?key=IP&q=Matthew

The Holy Bible, English Standard Version copyright ©2001 by Crossway Bibles, a publishing ministry of Good News Publishers. Used by permission. All rights reserved.