Developer Tools: API

Widget

Create

Highlighter - Beta

API

Application Programming Interface (API)

Versions

Versions are the specific editions of the Bible such as the New International Version (NIV) or King James Version (KJV). Versions have many books.

List

GET /versions.xml

Returns a list of all available versions.

Example:

Request

GET https://biblesearch.americanbible.org/versions.xml

Response

<?xml version="1.0" encoding="utf-8"?>
<versions>
  <version id='CEV'>
    <auditid>0</auditid>
    <version>CEV</version>
    <id>CEV</id>
    <name>Contemporary English Version</name>
    <short_desc>A short description of the GCEV</short_desc>
    <description>A full description of the GCEV</description>
    <active>1</active>
    <active_api>1</active_api>
    <orderindex>3</orderindex>
    <lang>eng</lang>
    <lang_code>ISO 639-3</lang_code>
    <copyright>
      <![CDATA[Copyright 2006, American Bible Society]]>
    </copyright>
    <contact_url>http://www.americanbible.org/about/contact</contact_url>
  </version>
  <version id='GNT'>
    <auditid>0</auditid>
    <version>GNT</version>
    <id>GNT</id>
    <name>Good News Translation</name>
    <short_desc>A short description of the Good News Testament</short_desc>
    <description>A full description of the Good News Testament</description>
    <active>1</active>
    <active_api>1</active_api>
    <orderindex>1</orderindex>
    <lang>eng</lang>
    <lang_code>ISO 639-3</lang_code>
    <copyright>
      <![CDATA[Scripture taken from the Good News Translation in Today's English Version- Second Edition Copyright © 1992 by American Bible Society. Used by Permission.]]>
    </copyright>
    <contact_url>http://www.americanbible.org/about/contact</contact_url>
  </version>
  [... Versions removed for brevity ...]
</versions>

GET /versions/#{version_id}/books.xml

Returns a list of all books for the specified version. The available version IDs can be listed with the versions endpoint.

Example:

Request

GET https://biblesearch.americanbible.org/versions/KJV/books.xml

Response

<?xml version="1.0" encoding="utf-8"?>
<books>
  <book id='KJV:Gen'>
    <version_id>2</version_id>
    <name>Genesis</name>
    <abbr>Gen</abbr>
    <ord>1</ord>
    <book_group_id>1</book_group_id>
    <testament>OT</testament>
    <id>KJV:Gen</id>
    <osis_end>KJV:Gen.50.26</osis_end>
    <parent>
      <version id='KJV'>
        <path>/versions/KJV</path>
        <name>King James Version</name>
        <id>KJV</id>
      </version>
    </parent>
    <next>
      <book id='KJV:Exod'>
        <path>/books/KJV:Exod</path>
        <name>Exodus</name>
        <id>KJV:Exod</id>
      </book>
    </next>
    <copyright>
      <![CDATA[The King James Version is public domain. Copy and distribute freely.]]>
    </copyright>
  </book>
  <book id='KJV:Exod'>
    <version_id>2</version_id>
    <name>Exodus</name>
    <abbr>Exod</abbr>
    <ord>2</ord>
    <book_group_id>1</book_group_id>
    <testament>OT</testament>
    <id>KJV:Exod</id>
    <osis_end>KJV:Exod.40.38</osis_end>
    <parent>
      <version id='KJV'>
        <path>/versions/KJV</path>
        <name>King James Version</name>
        <id>KJV</id>
      </version>
    </parent>
    <next>
      <book id='KJV:Lev'>
        <path>/books/KJV:Lev</path>
        <name>Leviticus</name>
        <id>KJV:Lev</id>
      </book>
    </next>
    <previous>
      <book id='KJV:Gen'>
        <path>/books/KJV:Gen</path>
        <name>Genesis</name>
        <id>KJV:Gen</id>
      </book>
    </previous>
    <copyright>
      <![CDATA[The King James Version is public domain. Copy and distribute freely.]]>
    </copyright>
  </book>
  [... Books removed for brevity ...]
</books>

List with Language

GET /versions.xml?language=#{language_id}

Returns a list of all versions specified by the language parameter. Use an ISO 639-2 abbreviation as the language parameter.

Example:

Request

GET https://biblesearch.americanbible.org/versions.xml?language=spa

Response

<?xml version="1.0" encoding="utf-8"?>
<versions>
  <version id='RVR60'>
    <auditid>0</auditid>
    <version>RVR60</version>
    <id>RVR60</id>
    <name>Reina-Valera 1960</name>
    <short_desc>A short description of the RVR60</short_desc>
    <description>A full description of the RVR60</description>
    <active>1</active>
    <orderindex>10</orderindex>
    <lang>spa</lang>
    <lang_code>ISO 639-3</lang_code>
    <copyright>
      <![CDATA[Scripture taken from the Reina Valera 1960. El texto Biblico ha sido tomado de la version Reina-Valera 1960 Sociedades Biblicas en America Latina;   renovado 1988 Sociedades Biblicas Unidas.  Utilizado con permiso.]]>
    </copyright>
    <contact_url>http://www.americanbible.org/about/contact</contact_url>
  </version>
</versions>

Show

GET /versions/#{version_id}.xml

Returns information about a specific version. The available version IDs can be listed with the versions endpoint.

Example:

Request

GET https://biblesearch.americanbible.org/versions/GNT.xml

Response

<?xml version="1.0" encoding="utf-8"?>
<versions>
  <version id='GNT'>
    <auditid>0</auditid>
    <version>GNT</version>
    <id>GNT</id>
    <name>Good News Translation</name>
    <short_desc>A short description of the Good News Testament</short_desc>
    <description>A full description of the Good News Testament</description>
    <active>1</active>
    <active_api>1</active_api>
    <orderindex>1</orderindex>
    <lang>eng</lang>
    <lang_code>ISO 639-3</lang_code>
    <copyright>
      <![CDATA[Scripture taken from the Good News Translation in Today's English Version- Second Edition Copyright © 1992 by American Bible Society. Used by Permission.]]>
    </copyright>
    <contact_url>http://www.americanbible.org/about/contact</contact_url>
  </version>
</versions>