Request Holdings and Item availability

URL request syntax

The base syntax is:

http://webservices.lib.harvard.edu/rest/v3/hollis/holdings/{HOLLIS_number}

There is also a way to get a “brief” response (described below), with the pattern:

http://webservices.lib.harvard.edu/rest/v2/classic/holdings/{HOLLIS_number}/brief

With optional jsonp callback parameter:

http://webservices.lib.harvard.edu/rest/v3/hollis/holdings/{HOLLIS_number}?jsonp={callback function name}

Parameters

Parameter	Value	Description
HOLLIS_number	record ID	ID number of the bibliographic record.
jsonp	Callback function name	The name of the callback function to wrap around JSON data. Example: ?jsonp=ws_results

Information provided in the response

Besides the basic library and collection information, as well as the Permanent Link to the bibliographic record in HOLLIS+, the following information is provided for each holding, where it is available (an asterisk (*) indicates that this information is provided for the “brief” response)

*Call number
*Any on-line URL
Binding information
Reproduction note
Provenance
Copy and version
Restrictions
Terms of use
Source of acquisition
Note
“Please Note” notation
*Holding Statement(s)
Supplements
Index

Additionally, if there are items associated with the holding, for each item there will be an item record containing the following, where available:

*Barcode
*Description (e.g.: “Volume 1”)
*Status (e.g.: “Not checked out | In-library use”)
Status code
Process status
Last return date (in YYYYMMDD format)

Sample URL

Requesting item availability information for HOLLIS record ID 011500528:

http://webservices.lib.harvard.edu/rest/v2/classic/holdings/011500528

Sample response

URL: http://webservices.lib.harvard.edu/rest/v2/classic/holdings/001252867 for Rabbit redux / John Updike, 1971

Sample XML Response

<?xml version="1.0" encoding="UTF-8"?>
<availability>
    <permalink>http://id.lib.harvard.edu/aleph/001252867/catalog</permalink>
    <branch>
        <repository>
            <id>HOU</id>
            <name>Houghton</name>
            <url> http://library.harvard.edu/ HOU</url>
        </repository>
        <collection>
            <collectionname> General Collection     </collectionname>
            <holding>
                <callnumber>*AC95.Up174R3.1971 (A) </callnumber>
                <binding>Trade issue bound in publisher's red cloth over boards; top edges stained blue; with printed and illustrated dust jacket. </binding>
                <provenance>From the library of John Updike, with his ms. corrections. </provenance>
                <items>
                    <itemrecord>
                        <stat>Not checked out | In-library use</stat>
                        <barcode>32044079932836</barcode>
                        <lastreturndate>00000000</lastreturndate>
                        <desc/>
                        <statuscode>02</statuscode>
                        <processStatus/>
                    </itemrecord>
                </items>
            </holding>
        </collection>
        <collection>
            <collectionname>Harvard Depository</collectionname>
            <holding>
                <callnumber>*AC95.Up174R3.1971 (B) </callnumber>
                <binding>Limited issue bound in publisher's printed white, orange, and blue cloth, backed in blue cloth; top edges stained orange; in black, orange, and blue paper-covered slipcase. </binding>
                <provenance>From the library of John Updike. </provenance>
                <copyAndVersion>"Of the first edition of Rabbit Redux, three hundred and fifty copies have been printed on special paper and specially bound. Each copy is signed by the author and numbered."--Colophon; written in place of copy number: "Out of series" </copyAndVersion>
                <items>
                    <itemrecord>
                        <stat>Not checked out | Ask in Houghton Reading Room</stat>
                        <barcode>HH3MQZ</barcode>
                        <lastreturndate>00000000</lastreturndate>
                        <desc/>
                        <statuscode>02</statuscode>
                        <processStatus>Harvard Depository status</processStatus>
                    </itemrecord>
                </items>
            </holding>
            <holding>
                <callnumber>AC95.Up174R3.1971 (C) </callnumber>
                <binding>Bound in publisher's red cloth over boards; top edges stained blue. </binding>
                <provenance>From the library of John Updike. </provenance>
                <copyAndVersion>This copy is from a collection of the author's works that the author kept together as a set, for purposes of recording changes and corrections for subsequent editions. </copyAndVersion>
                <copyAndVersion>With the author's manuscript corrections throughout, and a listing of the corrections on front flyleaf. </copyAndVersion>
                <copyAndVersion>Newspaper clipping of advertisement for Rabbit Redux affixed to front pastedown. </copyAndVersion>
                <items>
                    <itemrecord>
                        <stat>Not checked out | Ask in Houghton Reading Room</stat>
                        <barcode>32044135104537</barcode>
                        <lastreturndate>00000000</lastreturndate>
                        <desc/>
                        <statuscode>02</statuscode>
                        <processStatus>Harvard Depository status</processStatus>
                    </itemrecord>
                </items>
            </holding>
        </collection>
    </branch>
    <branch>
        <repository>
            <id>KIR</id>
            <name>Kirkland House</name>
            <url> http://library.harvard.edu/ KIR</url>
        </repository>
        <collection>
            <collectionname> General Collection     </collectionname>
            <holding>
                <callnumber>PS3571.P4 R27 1971 </callnumber>
            </holding>
        </collection>
    </branch>
    <branch>
        <repository>
            <id>LAM</id>
            <name>Lamont</name>
            <url> http://library.harvard.edu/ LAM</url>
        </repository>
        <collection>
            <collectionname> General Collection     </collectionname>
            <holding>
                <callnumber>PS3571.P4 R27x 1971 </callnumber>
                <items>
                    <itemrecord>
                        <stat>Checked out: due 03/21/16 11:59 PM | 28-day loan</stat>
                        <barcode>32044051838985</barcode>
                        <lastreturndate>20140514</lastreturndate>
                        <desc/>
                        <statuscode>28</statuscode>
                        <processStatus/>
                    </itemrecord>
                </items>
            </holding>
        </collection>
    </branch>
    <branch>
        <repository>
            <id>WID</id>
            <name>Widener</name>
            <url> http://library.harvard.edu/ WID</url>
        </repository>
        <collection>
            <collectionname> General Collection     </collectionname>
            <holding>
                <callnumber>ALB 7214.321.20 </callnumber>
                <items>
                    <itemrecord>
                        <stat>Not checked out | Regular loan</stat>
                        <barcode>32044021584776</barcode>
                        <lastreturndate>20100727</lastreturndate>
                        <desc/>
                        <statuscode>01</statuscode>
                        <processStatus/>
                    </itemrecord>
                </items>
            </holding>
        </collection>
    </branch>
</availability>