Scannable Docs
API referenceExaminations

List examinations

Returns your examinations, newest first. Narrow them with status. Pages by cursor: pass each response’s next_cursor as cursor until it is null.

GET
/v1/examinations

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.

status?string

Only the examinations with this status.

Value in"active""complete"

Response Body

A page of your examinations.

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/examinations'
Example response
{  "data": [    {      "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"    }  ],  "total": 42,  "limit": 20,  "next_cursor": "eyJwb3NpdGlvbiI6eyJjcmVhdGVkQXQiOiIyMDIxLTAyLTI1VDIzOjIzOjI5LjAwMFoiLCJ1aWQiOiJpdXNoOTN4djN4cnN2MWMifSwiZmlsdGVycyI6Imw5Rnc0VlVPN2tyOCJ9"}