Read a colour Candidate

GET

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

GET

/v1/digitisation/candidates/:candidate_id

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

{
  "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
}

One of your candidates: its candidate document, which never changes, and its review. review_status is pending until the candidate is accepted or rejected, once, at reviewed_at. Another account’s candidate, and one that does not exist, both answer 404 CANDIDATE_NOT_FOUND. 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.

Path parameters

candidate_idstringRequired

Response

The candidate

assessment_idstring

candidatemap from strings to any

candidate_sha256stringformat: "^[0-9a-f]{64}$"

colour_contract_versioninteger

created_atdatetime

derived_from_candidate_idstring or null

fieldsmap from strings to objects

idstring

review_statusenum

Allowed values:

reviewed_atdatetime or null

review_urlstring or nullOptional

reviewed_byobject or nullOptional

Who made a decision: user, a person in the Platform, or api_key. It names no person; the Platform shows who.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

503

Service Unavailable Error