Developer Tools: API

Application Programming Interface (API)

Chapters

Chapters are the sub-sections of a selected book. Chapters belong to books and have many verses.

List

Book listings may only be requested in the context their book parent.

GET /books/#{version_id}:#{book_id}/chapters.xml

Returns a list of all chapters for the specified book resource in the specified version. The available version IDs can be listed with the versions endpoint. The book ID is specified with the OSIS normative abbreviation for the book.

Example:

Request
GET https://biblesearch.americanbible.org/books/GNT:2Tim/chapters.xml
Response
<?xml version="1.0" encoding="utf-8"?>
<chapters>
  <chapter id="GNT:2Tim.1">
    <auditid>0</auditid>
    <label />
    <chapter>1</chapter>
    <id>GNT:2Tim.1</id>
    <osis_end>GNT:2Tim.1.18</osis_end>
    <parent>
      <book id="GNT:2Tim">
        <path>/books/GNT:2Tim</path>
        <name>2 Timothy</name>
        <id>GNT:2Tim</id>
      </book>
    </parent>
    <next>
      <chapter id="GNT:2Tim.2">
        <path>/chapters/GNT:2Tim.2</path>
        <name>2 Timothy 2</name>
        <id>GNT:2Tim.2</id>
      </chapter>
    </next>
    <previous>
      <chapter id="GNT:1Tim.6">
        <path>/chapters/GNT:1Tim.6</path>
        <name>1 Timothy 6</name>
        <id>GNT:1Tim.6</id>
      </chapter>
    </previous>
    <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>
  </chapter>
  <chapter id="GNT:2Tim.2">
    <auditid>0</auditid>
    <label />
    <chapter>2</chapter>
    <id>GNT:2Tim.2</id>
    <osis_end>GNT:2Tim.2.26</osis_end>
    <parent>
      <book id="GNT:2Tim">
        <path>/books/GNT:2Tim</path>
        <name>2 Timothy</name>
        <id>GNT:2Tim</id>
      </book>
    </parent>
    <next>
      <chapter id="GNT:2Tim.3">
        <path>/chapters/GNT:2Tim.3</path>
        <name>2 Timothy 3</name>
        <id>GNT:2Tim.3</id>
      </chapter>
    </next>
    <previous>
      <chapter id="GNT:2Tim.1">
        <path>/chapters/GNT:2Tim.1</path>
        <name>2 Timothy 1</name>
        <id>GNT:2Tim.1</id>
      </chapter>
    </previous>
    <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>
  </chapter>
  [... Chapters removed for brevity ...]
</chapters>

Show

GET /chapters/#{version_id}:#{book_id}.#{chapter_number}.xml

Returns the chapter specified by version, book, and chapter number. The available version IDs can be listed with the versions endpoint. The book ID is specified with the OSIS normative abbreviation for the book. The chapter number is a number that is a valid chapter in the book and version.

Example:

Request
GET https://biblesearch.americanbible.org/chapters/KJV:Acts.8.xml
Response
<?xml version="1.0" encoding="utf-8"?>
<chapters>
  <chapter id="KJV:Acts.8">
    <auditid>0</auditid>
    <label />
    <text>
      <![CDATA[<span class="v44_8_1"><sup class="v44_8_1">1</sup>And Saul was consenting unto his death.</span></span><span class="title-passage"><span>Saul Persecutes the Church</span></span><span class="v44_8_2"><sup class="v44_8_2">2</sup>And devout men carried Stephen to his burial, and made great lamentation over him.</span><span class="v44_8_3"><sup class="v44_8_3">3</sup>As for Saul, he made havoc of the church, entering into every house, and haling men and women committed them to prison.</span><span class="title-passage"><span>The Gospel Preached in Samaria</span></span><span class="para"><span class="v44_8_4"><sup class="v44_8_4">4</sup>Therefore they that were scattered abroad went every where preaching the word.</span><span class="v44_8_5"><sup class="v44_8_5">5</sup>Then Philip went down to the city of Samaria, and preached Christ unto them.</span><span class="v44_8_6"><sup class="v44_8_6">6</sup>And the people with one accord gave heed unto those things which Philip spake, hearing and seeing the miracles which he did.</span><span class="v44_8_7"><sup class="v44_8_7">7</sup>For unclean spirits, crying with loud voice, came out of many that were possessed with them: and many taken with palsies, and that were lame, were healed.</span><span class="v44_8_8"><sup class="v44_8_8">8</sup>And there was great joy in that city.</span></span><span class="para"><span class="v44_8_9"><sup class="v44_8_9">9</sup>But there was a certain man, called Simon, which beforetime in the same city used sorcery, and bewitched the people of Samaria, giving out that himself was some great one:</span><span class="v44_8_10"><sup class="v44_8_10">10</sup>to whom they all gave heed, from the least to the greatest, saying, This man is the great power of God.</span><span class="v44_8_11"><sup class="v44_8_11">11</sup>And to him they had regard, because that of long time he had bewitched them with sorceries.</span><span class="v44_8_12"><sup class="v44_8_12">12</sup>But when they believed Philip preaching the things concerning the kingdom of God, and the name of Jesus Christ, they were baptized, both men and women.</span><span class="v44_8_13"><sup class="v44_8_13">13</sup>Then Simon himself believed also: and when he was baptized, he continued with Philip, and wondered, beholding the miracles and signs which were done.</span></span><span class="para"><span class="v44_8_14"><sup class="v44_8_14">14</sup>Now when the apostles which were at Jerusalem heard that Samaria had received the word of God, they sent unto them Peter and John:</span><span class="v44_8_15"><sup class="v44_8_15">15</sup>who, when they were come down, prayed for them, that they might receive the Holy Ghost:</span><span class="v44_8_16"><sup class="v44_8_16">16</sup>(for as yet he was fallen upon none of them: only they were baptized in the name of the Lord Jesus.)</span><span class="v44_8_17"><sup class="v44_8_17">17</sup>Then laid they their hands on them, and they received the Holy Ghost.</span><span class="v44_8_18"><sup class="v44_8_18">18</sup>And when Simon saw that through laying on of the apostles' hands the Holy Ghost was given, he offered them money,</span><span class="v44_8_19"><sup class="v44_8_19">19</sup>saying, Give me also this power, that on whomsoever I lay hands, he may receive the Holy Ghost.</span><span class="v44_8_20"><sup class="v44_8_20">20</sup>But Peter said unto him, Thy money perish with thee, because thou hast thought that the gift of God may be purchased with money.</span><span class="v44_8_21"><sup class="v44_8_21">21</sup>Thou hast neither part nor lot in this matter: for thy heart is not right in the sight of God.</span><span class="v44_8_22"><sup class="v44_8_22">22</sup>Repent therefore of this thy wickedness, and pray God, if perhaps the thought of thine heart may be forgiven thee.</span><span class="v44_8_23"><sup class="v44_8_23">23</sup>For I perceive that thou art in the gall of bitterness, and in the bond of iniquity.</span><span class="v44_8_24"><sup class="v44_8_24">24</sup>Then answered Simon, and said, Pray ye to the Lord for me, that none of these things which ye have spoken come upon me.</span></span><span class="para"><span class="v44_8_25"><sup class="v44_8_25">25</sup>And they, when they had testified and preached the word of the Lord, returned to Jerusalem, and preached the gospel in many villages of the Samaritans.</span></span><span class="title-passage"><span>Philip and the Ethiopian Eunuch</span></span><span class="para"><span class="v44_8_26"><sup class="v44_8_26">26</sup>And the angel of the Lord spake unto Philip, saying, Arise, and go toward the south, unto the way that goeth down from Jerusalem unto Gaza, which is desert.</span><span class="v44_8_27"><sup class="v44_8_27">27</sup>And he arose and went: and, behold, a man of Ethiopia, a eunuch of great authority under Candace queen of the Ethiopians, who had the charge of all her treasure, and had come to Jerusalem for to worship,</span><span class="v44_8_28"><sup class="v44_8_28">28</sup>was returning, and sitting in his chariot read Isaiah the prophet.</span><span class="v44_8_29"><sup class="v44_8_29">29</sup>Then the Spirit said unto Philip, Go near, and join thyself to this chariot.</span><span class="v44_8_30"><sup class="v44_8_30">30</sup>And Philip ran thither to him, and heard him read the prophet Isaiah, and said, Understandest thou what thou readest?</span><span class="v44_8_31"><sup class="v44_8_31">31</sup>And he said, How can I, except some man should guide me? And he desired Philip that he would come up and sit with him.</span><span class="v44_8_32"><sup class="v44_8_32">32</sup>The place of the Scripture which he read was this,<span class="level1">He was led as a sheep to the slaughter;</span><span class="level1">and like a lamb dumb before his shearer,</span><span class="level1">so opened he not his mouth:</span></span><span class="v44_8_33"><span class="level1"><sup class="v44_8_33">33</sup>in his humiliation his judgment was taken away:</span><span class="level1">and who shall declare his generation?</span><span class="level1">for his life is taken from the earth.</span></span><span class="v44_8_34"><sup class="v44_8_34">34</sup>And the eunuch answered Philip, and said, I pray thee, of whom speaketh the prophet this? of himself, or of some other man?</span><span class="v44_8_35"><sup class="v44_8_35">35</sup>Then Philip opened his mouth, and began at the same Scripture, and preached unto him Jesus.</span><span class="v44_8_36"><sup class="v44_8_36">36</sup>And as they went on their way, they came unto a certain water: and the eunuch said, See, here is water; what doth hinder me to be baptized?</span><span class="v44_8_37"><sup class="v44_8_37">37</sup>And Philip said, If thou believest with all thine heart, thou mayest. And he answered and said, I believe that Jesus Christ is the Son of God.*</span><span class="v44_8_38"><sup class="v44_8_38">38</sup>And he commanded the chariot to stand still: and they went down both into the water, both Philip and the eunuch; and he baptized him.</span><span class="v44_8_39"><sup class="v44_8_39">39</sup>And when they were come up out of the water, the Spirit of the Lord caught away Philip, that the eunuch saw him no more: and he went on his way rejoicing.</span><span class="v44_8_40"><sup class="v44_8_40">40</sup>But Philip was found at Azo'tus: and passing through he preached in all the cities, till he came to Caesare'a.</span></span>]]>
    </text>
    <chapter>8</chapter>
    <id>KJV:Acts.8</id>
    <osis_end>KJV:Acts.8.40</osis_end>
    <parent>
      <book id="KJV:Acts">
        <path>/books/KJV:Acts</path>
        <name>Acts</name>
        <id>KJV:Acts</id>
      </book>
    </parent>
    <next>
      <chapter id="KJV:Acts.9">
        <path>/chapters/KJV:Acts.9</path>
        <name>Acts 9</name>
        <id>KJV:Acts.9</id>
      </chapter>
    </next>
    <previous>
      <chapter id="KJV:Acts.7">
        <path>/chapters/KJV:Acts.7</path>
        <name>Acts 7</name>
        <id>KJV:Acts.7</id>
      </chapter>
    </previous>
    <copyright>
      <![CDATA[The King James Version is public domain. Copy and distribute freely.]]>
    </copyright>
  </chapter>
</chapters>