SCSB Bib Availability Status

Bib Availability status API returns the availability statuses of items associated with the bibliographic record. Since it returns availability statuses of all items associated with a bib, it is likely to be used in partner ILS' Discovery systems to retrieve and display multiple item and their statuses in case of serials and multi volume monographs. The API also accepts both the owning institution's bibliographic id (the id used internally in the partner's ILS) and the bibliographic id generated by SCSB. The institutionId value needs to mention which institution's bibliographicId is being passed.


   Request - Bib Availability Status 
   API End Point : /sharedCollection/bibAvailabilityStatus


Requests prior to SCSB

Items that were requested and are out of storage location before the SCSB system went live are also marked as 'Not Available' by SCSB. This is done by translating IMS's item statuses to SCSB's as defined in this sheet.

Request - Bib Availability Status
{
  "bibliographicId": "773931", // Owning Institution's bibliographic id used internally in partner's ILS
  "institutionId": "<Institution Code>" // The owning institution's id. Example values are PUL, CUL, NYPL or SCSB.
}


Request - Bib Availability Status
{
  "bibliographicId": "2590526", //SCSB's bibliographic record id
  "institutionId": "SCSB"
}


Response - Bib Availability Status
[
  {
    "itemBarcode": "33433011172446",
    "itemAvailabilityStatus": "Not Available", // Item is not in storage facility
    "errorMessage": null
  },
  {
    "itemBarcode": "33433011172438",
    "itemAvailabilityStatus": "Available", // Item is in storage facility
    "errorMessage": null
  }
]


Alternate Response - Bib Availability Status
[
  {
    "itemBarcode": null,
    "itemAvailabilityStatus": null,
    "errorMessage": "Bib Id doesn't exist in SCSB database." // Bibliographic record doesn't exist is SCSB
  }
]