Service Name         Items List
Service Method      GET
Service URL             /epcs/items?page=1&per_page=10&query=xxx

Query Parameters
location = <tenant location like 001>                    (Required)
item_number = <item#>                                          (Optional)
query = <item# or part of item#>                          (Optional)
show_epcs = <boolean>                                           (Optional)
related_items = <boolean>                                      (Optional)
page = <start page for list pagination>                  (Optional)
per_page = <count of records in every page>      (Optional)

Note:
Default value for page is 1 and default value for per_page is 10. If you don't send value for query, API returns list of all items.

Request Header Fields
Content-Type = application/json
Authorization = <token>

Response Data (JSON)
{
"pagination": {
"current_page": <page number>,
"per_page": <page size>,
"total_entries": <total records count>
},
"items": [
{
"id": <item id>,
"number": "<item#>",
"name": "<item name>",
"upc": <item upc>,
"alu": "<item alu>",
"sku": "<item sku>",
"ean": "<item ean>",
"description": "<item description>",
"style": "<item style>",
"colour": "<item color>",
"size": "<item size>",
"dcs": "",
"dnc": false,
"total_qty": <item total quantity>,
"price": "<item price>",
"picture_url": "<item picture url>",
"item_type_name": "<item type>",
"categories": [
{
"id": <item-category code>,
"name": "<item-category name>"
}
],
"text1": "<item special text1>",
"text2": "<item special text2>",
"in_stock": <item in stock quantity>,
"epcs_count": <item epc count>,
"epcs": [
{
"id": <epc id>,
"epc_id": "<epc>",
"asset_id": "<serial number>",
"item_number": "<item number>",
"last_seen": "<last seen>",
"style": "<style>",
"handheld_last_seen": "<handheld last seen>",
"pallet_number": <pallet number>,
"case_number": <case number>,
"expiration_date": "<expiration date>",
"lot_number": "<lot number>",
"attr1": "<attr1>",
"attr2": "<attr2>",
"attr3": "<attr3>",
"text3": "<Text 3>",
"first_seen": "<first seen>",
"last_seen_antenna": "<last seen antenna>",
"last_zone": "<last zone>",
"handheld_reader": "<handheld reader>",
"alt_serial": "<alt serial>",
"current_units": <current units>,
"storage_unit": <storage unit>,
"adjust_qty": <adjust qty>,
"status": {
"id": <status id>,
"name": "<status name>"
},
"created_at": "<created at>",
"updated_at": "<updated at>"
}
]
},
...
]
}

Example
GET: http://app.senitron.net/api/v1/epcs/items?page=1&per_page=10&query=210000001433&show_epcs=true
{
"pagination": {
"current_page": 1,
"per_page": 10,
"total_entries": 1
},
"items": [
{
"id": 219717114,
"number": "210000001433",
"name": "PETER MILLAR M SHORT 99 - 32 -",
"upc":0,
"alu": "140195-001",
"sku": "9765567766",
"ean": "3525545634",
"description": "PETER MILLAR M SHORT 99 - 32 -",
"style": "",
"colour": "BLACK DRSG",
"size": "",
"dcs": "",
"dnc": false,
"total_qty": 0,
"price": "79.9900",
"picture_url": "",
"item_type_name": "Regular",
"categories": [
{
"id": 381228,
"name": "E4d"
}
],
"text1": "210000001433 PETER MILLAR M SHORT 99 - 32 -",
"text2": "BLACK DRSG,79.99",
"in_stock": 1,
"epcs_count": 1و
"epcs": [
{
"id": 8,
"epc_id": "C000C30E4F9B999000000400",
"asset_id": "1024",
"item_number": "210000001433",
"last_seen": "08/20/25 01:51 PM",
"style": "",
"handheld_last_seen": "07/04/2025 03:08 PM",
"pallet_number": 0,
"case_number": 0,
"expiration_date": "07/04/2027 03:08 PM",
"lot_number": "",
"attr1": "",
"attr2": "",
"attr3": "",
"text3": "Last Seen 08/20/2025 01:51 PM,HH-937 (HH)",
"first_seen": "11/18/24 05:40 PM",
"last_seen_antenna": "999901",
"last_zone": "Inside 101",
"handheld_reader": "HH-937",
"alt_serial": "",
"current_units": 1.0,
"storage_unit": 1.0,
"adjust_qty": 0,
"status": {
"id": 1000,
"name": "Live"
},
"created_at": "11/18/24 05:40 PM",
"updated_at": "08/20/25 01:51 PM"
}
]
}
]
}