IMS Item Status Check

ITEM STATUS CHECK

SCSB uses IMS item status check API to check the status of item in IMS and process accordingly for any requests such as Retrieval, Recall or EDD. The API is also used in Refile process and status reconciliation process. Whenever there is a need to check the status of an item in LAS this API is called.

IMS will accept JSON-encoded REST GET calls to retrieve the status of an item. Given a barcode, the itemStatus API will return the item’s owner and a string describing the item’s status in the IMS system.

Request format for item status

{ "itemStatus":
 [ 
   { "itemBarCode": "string" } 
   , { "itemBarCode": "string" }  ...
  ] 
}

Response format for item status

{ "dsitem":
 { "prods:hasChanges": boolean,      # IGNORE
   "prods:before":{ JSON data }      # IGNORE
   "ttitem": [
     { "itemBarcode":"string",
        "itemStatus":"string",
        "CustomerCode":"string"
     }  
     , { "itemBarcode":"string",
          "itemStatus":"string",
          "CustomerCode":"string"
      }  ...
   ],
 }
}

Sample items status call

curl -G -g -o - http://$HOST/lasapi/rest/lasapiSvc/itemStatus --data-urlencode \
'filter={ "itemStatus": [ 
  { "itemBarCode": "AR00035602" }
 ] }'

Field Descriptions for itemStatus api call

JSON field	Description / Typical usage	Data Type	Field width
itemBarcode	Item barcode	alphanum	20
CustomerCode	LAS Owner code	alphanum	3
itemStatus	Item Status	String	40