Scannable Docs
API referenceInspections

List inspections

Returns the inspections of the items in your inventory, most recently carried out first; inspections with no recorded date come last. Narrow them with item_id, status, type, inspector, inspected_after and inspected_before. Pages by cursor, so inspections recorded while you page are never skipped or repeated: pass each response’s next_cursor as cursor until it is null.

GET
/v1/inspections

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.

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.

item_id?string

Only the inspections of this item: its item_… identifier, or the serial_… one. An item of another organisation returns an empty page.

status?string

Only the inspections with any of these outcomes. Separate several with commas, such as failed,quarantined. One of: passed, failed, quarantined, monitoring.

type?string

Only the inspections of any of these kinds. Separate several with commas. One of: thorough, general.

inspector?string

Only the inspections this member carried out. A member of another organisation returns an empty page.

inspected_after?string

Only the inspections carried out at or after this time (ISO 8601). Inspections with no recorded date are left out.

inspected_before?string

Only the inspections carried out at or before this time (ISO 8601). Inspections with no recorded date are left out.

Response Body

A page of your inspections.

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/inspections'
Example response
{  "data": [    {      "id": "insp_7igae9yjg93sht5",      "item": {        "id": "item_gdwadfjn13zb7o5",        "serial_number": "21H0042871",        "name": "Harness 12"      },      "status": "passed",      "type": "thorough",      "inspected_at": "2026-03-02T09:30:00.000Z",      "inspector": {        "id": "member_tsyqfxifv1te4qf",        "name": "Tom Fraser"      },      "is_competent_inspector": true,      "notes": "Minor wear on the waist belt webbing.",      "created_at": "2026-03-02T09:31:00.000Z",      "updated_at": "2026-03-02T09:31:00.000Z"    }  ],  "total": 42,  "limit": 20,  "next_cursor": "eyJwb3NpdGlvbiI6eyJjcmVhdGVkQXQiOiIyMDIxLTAyLTI1VDIzOjIzOjI5LjAwMFoiLCJ1aWQiOiJpdXNoOTN4djN4cnN2MWMifSwiZmlsdGVycyI6Imw5Rnc0VlVPN2tyOCJ9"}