Synch_ItemByIDGet
This method will return an item record requested by the user. The item may be specified by item record ID.
Important: Only one item record may be requested at a time. Item record IDs must be numeric. If the item record requested does not exist, a row will not be returned. A call to AuthenticateStaffUser is required before calling any protected methods.
| GET | /protected/1/{AccessToken}/synch/item/{ItemID} |
Authorization required?
Yes
Protected method?
Yes
URI Parameters
|
Name |
Required |
Description/Notes |
|
ItemID |
Yes |
The item record ID. |
XML Elements Returned
|
Name |
Description/Notes |
|
PAPIErrorCode |
PAPI Error code: Negative values represent errors and are defined elsewhere. Note: On successful completion, the PAPI error code is populated with a positive integer representing the number of rows returned. |
|
ErrorMessage |
Error or information message |
|
ItemGetRows |
List of item data |
|
ItemGetRow |
Container for data |
|
LocationID |
Location identifier to which this piece is assigned. |
|
LocationName |
Location name to which this piece is assigned. |
|
CollectionID |
Collection identifier to which this piece is assigned. |
|
CollectionName |
Collection name to which this piece is assigned. |
|
Barcode |
Barcode assigned to the piece. |
|
PublicNote |
Public note of the piece. |
|
CallNumber |
Local call number of the piece. Includes VolumeNumber if exists. |
|
Designation |
Designation assigned to the piece. If the piece is not associated with serial then this value will be NULL. |
|
VolumeNumber |
Volume number assigned to the piece. |
|
ShelfLocation |
Shelf location assigned to the piece. |
|
CircStatus |
Circulation status of the piece. |
|
LastCircDate |
Last circulation date of the piece. |
|
MaterialType |
Material type of the piece. |
|
TextualHoldingsNote |
Textual holdings note associated with the assigned location/collection. |
|
RetentionStatement |
Retention statement associated with the assigned location. |
|
HoldingsStatement |
Holdings statement associated with the assigned location. |
|
HoldingsNote |
Holdings note associated with the assigned location. |
|
Holdable |
Specifies whether a hold can be placed on the piece. |
|
DueDate |
Specifies when the item is due back to the library. |
|
ItemRecordID |
The items record ID |
|
BibliographicRecordID |
The bibliographic record ID to which the item is attached |
|
IsDisplayInPAC |
Boolean true or false. Indicates if the library wishes the record to display in PAC. |
|
CreationDate |
The date and time that the record was created in the system. |
|
FirstAvailableDate |
The first available date for the bib is the first day the first item linked to the bib becomes available for circulation. This data may be NULL. |
|
ModificationDate |
The date and time of last record modification. This data may be NULL. |
|
NonCirculating |
Flags if the item is out of circulation. |
|
LoanableOutsideSystem |
Flags the item if it is loanable outside of the system. |
|
HasActiveHold |
Flags the item if it has active hold requests. |
Example
https://[HOSTNAME]/PAPIService/REST/protected/v1/1033/100/1/rGhOMQjR7MXZuJYREw6TQHPGsy1tlZPr/synch/item/572680
Return
<?xml version="1.0" encoding="UTF-8"?>
<ItemGetResult>
<PAPIErrorCode>0</PAPIErrorCode>
<ErrorMessage>string</ErrorMessage>
<ItemGetRows>
<ItemGetRow>
<LocationID>0</LocationID>
<LocationName>string</LocationName>
<CollectionID>0</CollectionID>
<CollectionName>string</CollectionName>
<Barcode>string</Barcode>
<PublicNote>string</PublicNote>
<CallNumber>string</CallNumber>
<Designation>string</Designation>
<VolumeNumber>string</VolumeNumber>
<ShelfLocation>string</ShelfLocation>
<CircStatus>string</CircStatus>
<LastCircDate>string</LastCircDate>
<MaterialType>string</MaterialType>
<TextualHoldingsNote>string</TextualHoldingsNote>
<RetentionStatement>string</RetentionStatement>
<HoldingsStatement>string</HoldingsStatement>
<HoldingsNote>string</HoldingsNote>
<Holdable>true</Holdable>
<DueDate>string</DueDate>
<ItemRecordID>0</ItemRecordID>
<BibliographicRecordID>0</BibliographicRecordID>
<IsDisplayInPAC>true</IsDisplayInPAC>
<CreationDate>2026-05-25T11:11:44.814Z</CreationDate>
<FirstAvailableDate>2026-05-25T11:11:44.814Z</FirstAvailableDate>
<ModificationDate>2026-05-25T11:11:44.814Z</ModificationDate>
<NonCirculating>true</NonCirculating>
<LoanableOutsideSystem>true</LoanableOutsideSystem>
<HasActiveHold>true</HasActiveHold>
</ItemGetRow>
</ItemGetRows>
</ItemGetResult>