Scannable Docs

List the history of an item

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.

GET
/v1/items/{item_id}/history

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.

Query Parameters

limit?integer

Page size (1–100). Defaults to 20.

Range1 <= value <= 100
Default20
cursor?string

The next_cursor of the previous page. Leave it out for the first page. A cursor only works with the filters it was issued for.

group?string

Only events of this kind.

Value in"scans""inspections""usage_and_tasks""assignments""inventory""assembly""record"

Response Body

A page of the item’s events, newest first.

application/json
  1. response
data*array<>
total*integer

The total number of results that match the filters.

Range-9007199254740991 <= value <= 9007199254740991
limit*integer

The page size applied to this response.

Range-9007199254740991 <= value <= 9007199254740991
next_cursor*|

Pass as cursor to fetch the next page. Null on the last page.

Example Request
curl -X GET 'https://api.scannable.io/v1/items/item_gdwadfjn13zb7o5/history'
Example response
{  "data": [    {      "type": "added_to_folder",      "title": "Added to Van 3",      "occurred_at": "2026-03-04T14:05:00.000Z",      "performed_by": {        "id": "member_tsyqfxifv1te4qf",        "name": "Sam Hill"      }    }  ],  "total": 42,  "limit": 20,  "next_cursor": "eyJwb3NpdGlvbiI6eyJjcmVhdGVkQXQiOiIyMDIxLTAyLTI1VDIzOjIzOjI5LjAwMFoiLCJ1aWQiOiJpdXNoOTN4djN4cnN2MWMifSwiZmlsdGVycyI6Imw5Rnc0VlVPN2tyOCJ9"}