Details:  Item Flags

URL:  https://yourlibrary.caiasoft.com/api/itemflags/v1/{flag_code}

HTTP Verb:  GET

Authorization Required:  

Name	Value	Required	Notes
X-API-Key	string	Yes	send in header

Parameters:  

Name	Value	Required	Notes
flag_code	string	Yes	Code (Not Description) of Flag, "ALL", or "GOOGLE" GOOGLE will show all flags identified on items associated with Google Rejections

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

Name	Value	Notes
success	true/false
error	string	API format/key errors only. Will only be filled in when success = false
item_count	integer	Count of Items with Flags Assigned
items -> item	string	Item Barcode
items -> flag_code	string	Flag Code applied to Item
items -> flag_description	array	Long Description of Flag
items -> assigned_date	int	Date Flag was Assigned to Item

Examples:  
API Call:

https://yourlibrary.caiasoft.com/api/itemflags/v1/LARGE

API Return:

{ "success": true, "error": "", "item_count": 2, "items": [ { "item": "99606984217", "flag_code": "LARGE", "flag_description": "Oversized Item - Cannot Scan in Standard Scanner", "assigned_date": "2025-12-15" }, { "item": "99602464884", "flag_code": "LARGE", "flag_description": "Oversized Item - Cannot Scan in Standard Scanner", "assigned_date": "2025-12-15" } ] }