Request Holdings and Item availability

WIth the new ALMA system undergirding HOLLIS, holding and availability information is provided separately.

Holdings

URL request syntax

The base syntax is:

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

~~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. This may be either the Alma (MMS) ID, or, for backward compatibility, the old HOLLIS ("Aleph") ID
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 total_record_count, the following is provided

Alma (MMS) ID
Author
Barcode
Call number
Description
Is the holding in a temporary location?
Library code
Location (permanent)
Publication place and publisher
Temporary call number
Temporary library
Temporary location
Temporary policy
Title

Sample URL

Requesting holdings information for HOLLIS record ID 011500528:
http://webservices.lib.harvard.edu/rest/v3/hollis/holdings/011500528

~~http://webservices.lib.harvard.edu/rest/v3/hollis/holdings/011500528?jsonp=holdings~~

Sample response

~~URL: http://webservices.lib.harvard.edu/rest/v3/hollis/holdings/001252867?jsonp=hold for Rabbit redux / John Updike, 1971~~

Response

hold({"items": {
  "item": [
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": 32044051800407,
      "call_number": "PS3571.P4 R27 1971x",
      "description": {},
      "in_temp_location": false,
      "library": "QUA",
      "location": "HIGH",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    },
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": 32044051838985,
      "call_number": "PS3571.P4 R27x 1971",
      "description": {},
      "in_temp_location": false,
      "library": "LAM",
      "location": "GEN",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    },
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": 32044021584776,
      "call_number": "ALB 7214.321.20",
      "description": {},
      "in_temp_location": false,
      "library": "WID",
      "location": "GEN",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    },
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": 32044079932836,
      "call_number": "*AC95.Up174R3.1971 (A)",
      "description": {},
      "in_temp_location": false,
      "library": "HOU",
      "location": "GEN",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    },
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": "HH3MQZ",
      "call_number": "*AC95.Up174R3.1971 (B)",
      "description": {},
      "in_temp_location": false,
      "library": "HOU",
      "location": "HD",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    },
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": 32044135104537,
      "call_number": "AC95.Up174R3.1971 (C)",
      "description": {},
      "in_temp_location": false,
      "library": "HOU",
      "location": "HD",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    }
  ],
  "total_record_count": 6
}})

Availability

URL request syntax

The base syntax is:

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

~~With optional jsonp callback parameter:~~

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

Parameters

Parameter	Value	Description
HOLLIS_number	record ID	ID number of the bibliographic record. This may be either the Alma (MMS) ID, or, for backward compatibility, the old HOLLIS ("Aleph") ID
jsonp	Callback function name	The name of the callback function to wrap around JSON data. Example: ?jsonp=ws_results

Information provided in the response

Beside the Author, MMS ID, and Title, each holding has the following information:

Call number
Holding ID (note that subsequent development may find a use for this number)
Library name and code
Location
Number not available
Status
Total items

Sample URL

Requesting availability information for bib record 990012528670203941 (Rabbit Redux)

http://webservices.lib.harvard.edu/rest/avail/hollis/990012528670203941?jsonp=av

Response

av({"availability": {
  "author": "Updike, John",
  "items": {"item": [
    {
      "callnumber": "*AC95.Up174R3.1971 (A)",
      "holding": 221798074030003941,
      "library": "Houghton Library (HOU)",
      "location": "GEN",
      "nonAvail": 0,
      "status": "available",
      "totalItems": 1
    },
    {
      "callnumber": "*AC95.Up174R3.1971 (B)",
      "holding": 221798073930003941,
      "library": "Houghton Library (HOU)",
      "location": "Offsite Storage",
      "nonAvail": 0,
      "status": "available",
      "totalItems": 1
    },
    {
      "callnumber": "AC95.Up174R3.1971 (C)",
      "holding": 221798073860003941,
      "library": "Houghton Library (HOU)",
      "location": "Offsite Storage",
      "nonAvail": 0,
      "status": "available",
      "totalItems": 1
    },
    {
      "callnumber": "PS3571.P4 R27 1971",
      "holding": 221798073830003941,
      "library": "Kirkland House (KIR)",
      "location": "GEN",
      "nonAvail": {},
      "status": "check_holdings",
      "totalItems": {}
    },
    {
      "callnumber": "PS3571.P4 R27x 1971",
      "holding": 221798074120003941,
      "library": "Lamont Library (LAM)",
      "location": "GEN",
      "nonAvail": 0,
      "status": "available",
      "totalItems": 1
    },
    {
      "callnumber": "ALB 7214.321.20",
      "holding": 221798074080003941,
      "library": "Widener Library (WID)",
      "location": "Old Widener",
      "nonAvail": 0,
      "status": "available",
      "totalItems": 1
    }
  ]},
  "mmsid": 990012528670203941,
  "title": "Rabbit redux /"
}})