Verse of the Day API

This is a description of the API available for the Verse of the Day web service. This service allows you to display the Verse of the Day. This documentation is intended for advanced users. If you're just interested in quickly adding the Verse of the Day to your website, the Verse of the Day tutorial is a much easier place to start.

The Verse of the Day uses the SOAP protocol; if you do not already have a SOAP package installed, please obtain one from the SOAP::Lite project for a Perl implementation or the NuSOAP project for a PHP implementation.

Services

Function name doGetVotd()
Description Returns the verse of the day in one of the specified output formats.
Parameters The doGetVotd() service takes two parameters (associative arrays), which are listed below. View the parameter listing for a more detailed description of the fields available.

Preferences:
  • version_id
  • utc_offset
Options:
  • include-copyright

 Output format XML
 Usage example Perl (using the SOAP::Lite module)

PHP (using the NuSOAP library)

XML Output

The XML format provides the verse of the day as xml.

Sample Output

(formatted for clarity)
<?xml version='1.0' encoding='UTF-8' ?>

<bgvotd xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
           xsi:noNamespaceSchemaLocation='http://www.biblegateway.com/soap/votd/schemas/BgVotd.xsd'>

 <details>
    <copyright>
       <version>New International Version</version>
       <short>
       <url>
           http://www.biblegateway.com/languages/index.php?language=english&amp;version=NIV
       </url>
       <notice>[NIV]</notice>
       </short>

       <long>
       <url>
           http://www.biblegateway.com
       </url>
       <notice>Powered by BibleGateway.com</notice>
       </long>
    </copyright>

    <verseurl>
        http://www.biblegateway.com/bible?language=english&amp;version=NIV&amp;passage=Philippians 1:29
    </verseurl>
    
    <audiourl>
  http://www.biblegateway.com/bgaudio/english/NIV/Max%20McLean/RM/hurl?passage=LUKE+9
    </audiourl>

  </details>

 <results>
    <verseref>Philippians 1:29</verseref>
    <verse>
        For it has been granted to you on behalf of Christ not only to believe on him, but also to suffer for him,
    </verse>
 </results>

</bgvotd>