Skip to end of metadata
Go to start of metadata

This request will return holdings and item information for all items associated with a bibliographic record ID.

Authorization

None required.

URL request syntax

The base syntax is:

http://webservices.lib.harvard.edu/rest/v2/classic/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/v2/classic/holdings/{HOLLIS_number}?jsonp={callback function name}

and for the “brief” response:

http://webservices.lib.harvard.edu/rest/v2/classic/holdings/{HOLLIS_number}/brief?jsonp={callback function name}

Note: when there are multiple elements within the response, for example, more than one collection for a holding, the jsonp format will return them as an array of objects associated with the element. Example of a library with multiple collections 014616485, versus a library with single collection: 014472259.

 

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

  • No labels