Scannable Docs
API referenceExaminations

Retrieve an examination

Returns one of your examinations.

GET
/v1/examinations/{examination_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

examination_id*string

The exam_… identifier of an examination.

Response Body

The requested examination.

application/json
  1. response
id*string

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

job_reference*|

Your job reference for the examination, if you gave one.

status*string

active while inspections are being added, complete once issued.

Value in"active""complete"
issued_at*|

When the report was issued (ISO 8601), once it has been.

inspector*|

The name of the competent person who carried it out.

customer*|

The customer organisation the examination was for, if any.

inspection_count*integer

How many inspections the examination holds.

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

Notes recorded with the examination.

created_at*string

When the examination was started (ISO 8601).

updated_at*string

When the examination last changed (ISO 8601).

declaration*|

The declaration printed on the report.

Example Request
curl -X GET 'https://api.scannable.io/v1/examinations/exam_u6ff38egif4wibp'
Example response
{  "id": "exam_u6ff38egif4wibp",  "job_reference": "JOB-2041",  "status": "complete",  "issued_at": "2026-03-02T09:30:00.000Z",  "inspector": "Tom Fraser",  "customer": "Skyline Gondolas",  "inspection_count": 18,  "notes": "Annual thorough examination of the rope access kit.",  "created_at": "2026-03-02T09:30:00.000Z",  "updated_at": "2026-03-02T09:30:00.000Z",  "declaration": "The equipment listed is safe to use until the next examination."}