List labels
Returns the labels in your organisation, by name. Pass each response’s next_cursor as cursor to fetch the next page, until it is null.
ApiKeyAuthorizationBearer <token>Your organisation's API key. Send it as Authorization: Bearer <key>. Create one in the Scannable admin under Settings → API keys.
limit?integerPage size (1–100). Defaults to 20.
1 <= value <= 10020cursor?stringThe next_cursor of the previous page. Leave it out for the first page. A cursor only works with the filters it was issued for.
A page of your labels, by name.
application/json- response
data*array<>total*integerThe total number of results that match the filters.
-9007199254740991 <= value <= 9007199254740991limit*integerThe page size applied to this response.
-9007199254740991 <= value <= 9007199254740991next_cursor*|Pass as cursor to fetch the next page. Null on the last page.
curl -X GET 'https://api.scannable.io/v1/labels'{ "data": [ { "id": "label_b2y6zp7hhpv76de", "name": "Rescue kit", "created_at": "2026-03-02T09:30:00.000Z" } ], "total": 42, "limit": 20, "next_cursor": "eyJwb3NpdGlvbiI6eyJjcmVhdGVkQXQiOiIyMDIxLTAyLTI1VDIzOjIzOjI5LjAwMFoiLCJ1aWQiOiJpdXNoOTN4djN4cnN2MWMifSwiZmlsdGVycyI6Imw5Rnc0VlVPN2tyOCJ9"}Retrieve a folder GET
Returns one folder in your organisation, with the members and teams that have a permission on it. An API key can read a restricted folder. An OAuth caller can read it only with access to it.
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.