/itemsbybarcode

Details:  Items by Barcode - JSON sent to URL to find item status and info on one or more items in a single post

URL:  https://yourlibrary.caiasoft.com/api/itemsbybarcode/v1

HTTP Verb:  POST

Content-Type:  application/json

Authorization Required:  

NameValueRequiredNotes
X-API-KeystringYessend in header

Parameters:  JSON Formatted in the following format:
{“barcodes":[
Comma separated barcode array
]}

NameValueRequiredNotes
barcodeitem barcode arrayYesComma separated if more than one barcode

Return Response:  
{“success”:”true/false”, “error”:”string”, “item_count”:”int”, "items":[ { “name”:”value” (see items-> section of table below) } ]}

NameValueNotes
successtrue/false
errorstringAPI format/key errors only. Will only be filled in when success = false
item_countinteNumber of items received to update
items->barcodestringItem Barcode
items->statusstringItem Status (see Additional info for complete status list)
items->collectionstringcollection
items->materialstringMaterial
items->titlestringTitle
items->volumestringVolume
items->call numberstringCall Number
items->publisherstringPublisher
items->pub placestringPub Place
items->pub yearstringPub Year
items->item idstringItem ID (from ILS)
ALMA MMS ID
items->bib record nbrstringItem Bib Record Number (from ILS)
ALMA Holding ID
items->pidstringALMA PID
Note: will be blank for all other ILS connections
items->accession datestring mm/dd/yyyyAccession Date
items->last status datestring mm/dd/yyyyLast Status Update Date

Examples:  
API Call & JSON:

https://yourlibrary.caiasoft.com/api/itemsbybarcode/v1
{ "barcodes":
["33433096043124",
"308021014967264",
"33433096043280"]
}



API Return:

{"success":true,"error":"","item_count":"3",
"items":[ {"barcode":"33433096043124","status":"Pulled for E-Retrieval","collection":"DEMO","material":"BOOK","title":"","volume":null,"call number":"","item id":"","bib record nbr":"","accession date":"06-20-2016","last status update":"05-10-2019"}, {"barcode":"308021014967264","status":"Item Waiting on the External Retrieval Queue - Request ID 0","collection":"DEMO","material":"BOOK","title":"","volume":null,"call number":"","item id":"","bib record nbr":"","accession date":"06-20-2016","last status update":"06-20-2016"}, {"barcode":"33433096043280","status":"Item has been Deaccessioned","collection":"DEMO","material":"BOOK","title":"","volume":null,"call number":"","item id":"","bib record nbr":"","accession date":"06-20-2016","last status update":"10-19-2017"}
]}


Full list of Statuses that can be returned