Scannable Docs

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.

GET
/v1/items/{item_id}

Authorization

ApiKey
headerAuthorizationBearer <token>

Your organisation's API key. Send it as Authorization: Bearer <key>. Create one in the Scannable admin under Settings → API keys.

Path Parameters

item_id*string

The item_… identifier of an item in your inventory. The serial_… identifier of the same item works too.

Response Body

The requested item.

application/json
  1. response
id*string

The item identifier you use to address it in the API.

serial_id*string

The 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*string

The 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.

Value in"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*boolean

Whether you have archived the item in your inventory.

created_at*string

When 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.

Example Request
curl -X GET 'https://api.scannable.io/v1/items/item_gdwadfjn13zb7o5'
Example response
{  "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"    }  ]}