Retrieve an item
Returns one item in your inventory, archived or not, with the values of your organisation’s fields and the inspection frequencies applied to it. Address it by its item_… identifier, or by the serial_… identifier the manufacturer API uses for the same item.
ApiKeyAuthorizationBearer <token>Your organisation's API key. Send it as Authorization: Bearer <key>. Create one in the Scannable admin under Settings → API keys.
item_id*stringThe item_… identifier of an item in your inventory. The serial_… identifier of the same item works too.
The requested item.
application/json- response
id*stringThe item identifier you use to address it in the API.
serial_id*stringThe same item as the serial_… identifier the manufacturer API uses. Either identifier addresses the item in the item routes.
serial_number*|The serial number of the item, if it has one.
name*|The name you gave the item, if any.
status*stringThe safety status of the item: safe_passed, not_safe_failed, not_safe_expired, not_safe_overdue, not_safe_quarantined, not_safe_recalled, not_safe_not_inspected, safety_notice or none.
"safe_passed""not_safe_failed""not_safe_expired""not_safe_overdue""not_safe_quarantined""not_safe_recalled""not_safe_not_inspected""safety_notice""none"product*|What the item is an item of. Null for an item with no catalogue product.
sku*|The SKU the item is an item of. Null for an item with no SKU.
folder*|The folder that holds the item. Null for an item at the top level of your inventory.
assigned_to*|The member the item is assigned to. Null for an unassigned item.
labels*array<>Your labels on the item, by name.
manufactured_at*|When the item was manufactured (ISO 8601), if recorded.
first_used_at*|When the item was first used (ISO 8601), if recorded.
expires_at*|When the item expires (ISO 8601), if it has an expiry.
last_inspection*|The latest inspection of the item, so its result and notes come without another call. Null if it has never been inspected.
next_inspection_at*|When the next inspection is due (ISO 8601), if one is.
archived*booleanWhether you have archived the item in your inventory.
created_at*stringWhen the item was created (ISO 8601).
data_fields*array<>Your organisation’s own fields that have a value on this item, in your field order. File fields are left out.
inspection_frequencies*array<>The inspection frequencies applied to this item, soonest due first.
curl -X GET 'https://api.scannable.io/v1/items/item_gdwadfjn13zb7o5'{ "id": "item_gdwadfjn13zb7o5", "serial_id": "serial_gdwadfjn13zb7o5", "serial_number": "21H0042871", "name": "Harness 12", "status": "safe_passed", "product": { "id": "prod_hqycu1g6t1yyt16", "name": "AVAO BOD FAST", "manufacturer": "Petzl" }, "sku": { "id": "sku_wnpil4kqbhgv5o5", "part_number": "C071CA01", "name": "AVAO BOD FAST, size 1" }, "folder": { "id": "folder_0oiuplyrd7v1tw7", "name": "Rope Access Kit" }, "assigned_to": { "id": "member_tsyqfxifv1te4qf", "name": "Mere Walker" }, "labels": [ { "id": "label_14nvy9743mll6el", "name": "Rescue kit" } ], "manufactured_at": "2026-03-04T14:05:00.000Z", "first_used_at": "2026-03-04T14:05:00.000Z", "expires_at": "2026-03-04T14:05:00.000Z", "last_inspection": { "id": "insp_7igae9yjg93sht5", "status": "failed", "type": "thorough", "inspected_at": "2026-03-04T14:05:00.000Z", "notes": "Webbing abraded behind the rear D-ring." }, "next_inspection_at": "2026-03-04T14:05:00.000Z", "archived": false, "created_at": "2026-03-04T14:05:00.000Z", "data_fields": [ { "id": "data_cztnsj2mtmvfb82", "name": "Asset tag", "type": "text", "value": "AT-0042", "unit": "m", "visibility": "internal" } ], "inspection_frequencies": [ { "frequency_id": "freq_fu760equhw69jld", "name": "6-monthly thorough", "due_at": "2026-03-04T14:05:00.000Z", "starts_at": "2026-03-04T14:05:00.000Z" } ]}List items GET
Returns the items in your inventory, oldest `created_at` first, or soonest due first with `sort=next_inspection_at`. An API key reads your whole organisation, whatever folder permissions say. Find an item with `serial_number`, `nfc_tag` or `q` (text in the serial number, name, product or SKU). Add `include=data_fields,inspection_frequencies` to get what the single item carries without a call per item. Narrow the list with `folder_id` (which includes the folders inside it), `label_id`, `assigned_to`, `status`, `product_id`, `sku_id`, `next_inspection_before`, `next_inspection_after` and `expires_before`. Archived items are left out unless you send `archived=true`. Pass each response’s `next_cursor` as `cursor` to fetch the next page, until it is null.
List the history of an item GET
Returns the events recorded against an item in your inventory, newest first. From before your organisation began holding the item, only its inspections show, without who carried them out. It leaves out other organisations’ labels and the manufacturer’s own operations, and a manufacturer’s inspections show without the inspector. Filter by `group`. Pages by cursor, unlike other lists, so events recorded while you page are never skipped or repeated: pass each response’s `next_cursor` as `cursor` until it is null.