List colour Candidates

GET

https://api.morphiaone.ai/v1/digitisation/candidates

GET

/v1/digitisation/candidates

curl https://api.morphiaone.ai/v1/digitisation/candidates \
     -H "X-API-Key: <apiKey>"

{
  "data": [
    {
      "assessment_id": "assessment_3t38gf4mbt0y96z8pzmp4w5mpq",
      "candidate": {
        "assessment_id": "assessment_3t38gf4mbt0y96z8pzmp4w5mpq",
        "assessment_output_sha256": "67b810e77d19f628534a2128d402605b8cc81aa1d43828793f2701f19ce8b97a",
        "colour_contract_version": 1,
        "kind": "digitisation.candidate",
        "report": {
          "analyzed_bytes_sha256": "9229dacfcfb7a93b54efccf2119c2e417546d10ed3fce2a18a067294b646c5a2",
          "clipped_fraction": 0,
          "colour_contract_version": 1,
          "icc_profile_sha256": null,
          "image": {
            "height": 64,
            "width": 64
          },
          "kind": "digitisation.colour_report",
          "lab_d65": [
            33.3028,
            42.2729,
            -74.7134
          ],
          "mean_linear_rgb": [
            0.012983,
            0.045186,
            0.57758
          ],
          "region": [
            0,
            0,
            32,
            32
          ],
          "source_colour": "untagged",
          "srgb_hex": "#1E3CC8"
        },
        "report_sha256": "13b9231215003368dc58598699f5aaf93c8b49b13561c1667aebbb065681110f",
        "source": {
          "analyzed_bytes_sha256": "9229dacfcfb7a93b54efccf2119c2e417546d10ed3fce2a18a067294b646c5a2",
          "evidence_id": "evidence_6952rp5rnjq4bpn9sk93vbq6pv",
          "region": [
            0,
            0,
            32,
            32
          ]
        }
      },
      "candidate_sha256": "e1e9fdf2e1a9fe90712dad6a3247af7c4b6b6144d770a9070983f1d665fe71bb",
      "colour_contract_version": 1,
      "created_at": "2026-10-22T03:21:05.118204Z",
      "derived_from_candidate_id": null,
      "fields": {
        "display_color": {
          "status": "measured",
          "value": "#1E3CC8"
        },
        "material.finish": {
          "status": "abstained",
          "value": null
        }
      },
      "id": "candidate_5w2kq8n4fz7yr3tm6vx9bhcj1d",
      "review_status": "pending",
      "reviewed_at": null
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Your candidates, newest first: the review queue. Repeat review_status (pending, accepted, rejected) to narrow the list, or send assessment_id for the candidates one assessment produced. 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.

review_statuslist of strings or nullOptional

Only candidates in these review states (repeatable): pending, accepted, rejected.

assessment_idstring or nullOptional

Only the candidates measured by this assessment.

Response

A page of the caller's candidates, 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