Scannable Docs
API referenceInspections

Retrieve an inspection

Returns one inspection of an item in your inventory, with the checklist it was made against, the result of each check, and its photos and PDFs. PDF links work for an hour; photo links don’t expire.

GET
/v1/inspections/{inspection_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

inspection_id*string

The insp_… identifier of an inspection.

Response Body

The requested inspection.

application/json
  1. response
id*string

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

item*

The item that was inspected.

status*string

The outcome of the inspection: passed, failed, quarantined or monitoring.

Value in"passed""failed""quarantined""monitoring"
type*string

The kind of inspection: thorough or general.

Value in"thorough""general"
inspected_at*|

When the inspection was carried out (ISO 8601), or null if no date was recorded.

inspector*|

Who carried out the inspection. Null for a manufacturer’s own inspection, or one recorded without an inspector.

is_competent_inspector*boolean

Whether the inspector was recorded as a competent person for this inspection.

notes*|

The notes recorded with the inspection, if any.

created_at*string

When the inspection was recorded (ISO 8601).

updated_at*string

When the inspection was last changed (ISO 8601).

checklist*|

The checklist the inspection was made against. Null for an inspection made without one.

results*array<>|

The result of each check on the checklist, in checklist order. Null for an inspection made without a checklist.

attachments*array<>

The photos and PDFs recorded with the inspection.

Example Request
curl -X GET 'https://api.scannable.io/v1/inspections/insp_7igae9yjg93sht5'
Example response
{  "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",  "checklist": {    "id": "chk_zsged1q41baxq7s",    "name": "Harness inspection"  },  "results": [    {      "title": "Webbing free of cuts",      "description": "Check the full length, including under buckles.",      "order": 1,      "result": "passed",      "notes": "Slightly stiff"    }  ],  "attachments": [    {      "type": "pdf",      "name": "Inspection sheet.pdf",      "url": "https://s3.us-west-2.amazonaws.com/scannable-storage/inspections/292dd4ed-79e3-451a-813a-be250dc4f1af.pdf?X-Amz-Expires=3600",      "expires_at": "2026-03-02T10:31:00.000Z"    }  ]}