{"id":372,"date":"2020-04-29T18:32:14","date_gmt":"2020-04-29T18:32:14","guid":{"rendered":"https:\/\/senitron.net\/developers\/?page_id=372"},"modified":"2025-08-20T23:59:55","modified_gmt":"2025-08-20T23:59:55","slug":"restapi-items-list","status":"publish","type":"page","link":"https:\/\/senitron.net\/developers\/restapi-items-list\/","title":{"rendered":"RESTAPI-Items List"},"content":{"rendered":"
<\/div>
<\/div><\/div>
<\/div>

Service Name<\/span> \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Items List<\/span>
\nService Method<\/span> \u00a0\u00a0\u00a0\u00a0 GET<\/span>
\nService URL<\/span> \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0 \u00a0 \/epcs\/items?page=1&per_page=10&query=xxx<\/span><\/span><\/p>\n

Query Parameters<\/span>
\nlocation<\/span> = <tenant location like 001<\/span>>\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 (Required)<\/span>
\nitem_number<\/span> = <item#<\/span>>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 (Optional)<\/span>
\nquery<\/span> = <item# or part of item#<\/span>>\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 (Optional)<\/span>
\nshow_epcs<\/span> = <boolean<\/span>>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0(Optional)<\/span>
\nrelated_items<\/span> = <boolean<\/span>>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 (Optional)<\/span>
\npage<\/span> = <start page for list pagination<\/span>>\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 (Optional)<\/span>
\nper_page<\/span> = <count of records in every page<\/span>>\u00a0\u00a0\u00a0\u00a0\u00a0 (Optional)<\/span><\/p>\n

Note:
\nDefault 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.<\/p>\n

Request Header Fields<\/span>
\nContent-Type <\/span>= application\/json<\/span>
\nAuthorization <\/span>= <token<\/span>><\/p>\n

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

 <\/p>\n

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

<\/div><\/div><\/div><\/div><\/div>\n","protected":false},"excerpt":{"rendered":"","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"side-navigation.php","meta":{"footnotes":""},"class_list":["post-372","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/senitron.net\/developers\/wp-json\/wp\/v2\/pages\/372","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/senitron.net\/developers\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/senitron.net\/developers\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/senitron.net\/developers\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/senitron.net\/developers\/wp-json\/wp\/v2\/comments?post=372"}],"version-history":[{"count":8,"href":"https:\/\/senitron.net\/developers\/wp-json\/wp\/v2\/pages\/372\/revisions"}],"predecessor-version":[{"id":2110,"href":"https:\/\/senitron.net\/developers\/wp-json\/wp\/v2\/pages\/372\/revisions\/2110"}],"wp:attachment":[{"href":"https:\/\/senitron.net\/developers\/wp-json\/wp\/v2\/media?parent=372"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}