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
ApiKeyheader
AuthorizationBearer <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.
Range
1 <= value <= 100Default
20cursor?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.
status?stringOnly the examinations with this status.
Value in
"active""complete"A page of your examinations.
application/json- response
data*array<>total*integerThe total number of results that match the filters.
Range
-9007199254740991 <= value <= 9007199254740991limit*integerThe page size applied to this response.
Range
-9007199254740991 <= value <= 9007199254740991next_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"}