Skip to navigation

List colour Assessments

Your assessments, newest first. Repeat status (queued, running, succeeded, failed, cancelled) to narrow the list. Pages are chained with next_cursor, opaque and bound to this query’s filters and to you: send it back with the same filters, or the answer is 400 INVALID_CURSOR. An unknown or repeated parameter, and a filter value that is not valid, is 400 INVALID_REQUEST naming it. Requires the digitisation.read scope, which your account operator provisions; served only where digitisation is enabled for your environment.

Authentication

X-API-Keystring

API key for one environment of your account. Keep server-side; never expose in browser clients.

Query parameters

limitstring or nullOptional

Page size, an integer 1-100 (default 20).

cursorstring or nullOptional

The previous page’s next_cursor.

statuslist of strings or nullOptional

Only assessments in these states (repeatable): queued, running, succeeded, failed, cancelled.

Response

A page of the caller's assessments, newest first
datalist of objects
has_moreboolean
next_cursorstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
503
Service Unavailable Error