Retrieve a triage job

GET

/api/identity/address-triage/:jobId

GET

/api/identity/address-triage/:jobId

curl https://sandbox-api.toden.co/api/identity/address-triage/jobId \
     -H "Authorization: Bearer <apiKey>"

{
  "job": {
    "id": "cm9x2k4m80006",
    "status": "COMPLETED",
    "totalCount": 2,
    "succeededCount": 2,
    "failedCount": 0,
    "createdAt": "2026-09-04T09:00:00.000Z",
    "meta": {
      "preview": false,
      "country": "NG",
      "fileName": null,
      "uploadedRows": 2
    },
    "scrubbedAt": null,
    "completedAt": "2026-09-04T09:00:04.000Z"
  },
  "distribution": {
    "graded": 2,
    "pending": 0,
    "failed": 0,
    "byGrade": {
      "corroborated": 1,
      "confirmable_in_app": 1,
      "needs_presence": 0,
      "unresolvable": 0
    },
    "strong": 1,
    "reachable": 1,
    "unusable": 0,
    "duplicates": {
      "affectedRows": 0,
      "clusters": 0,
      "top": []
    },
    "remediation": {
      "minted": 0,
      "opened": 0,
      "submitted": 0,
      "expired": 0
    }
  }
}

Returns the job and the distribution of its rows across the grades, with shared addresses and the progress of any remediation links. Read only, and not billed. Individual rows are not returned here.

Error codes

`error`	Status	Meaning
`triage_job_not_found`	404	No triage job has this identifier in this organisation and environment.
`secret_key_required`	403	A publishable key was used. This API accepts secret keys only.
`environment_mismatch`	403	The key belongs to an environment this host does not serve.
`rate_limited`	429	The request rate limit for this key was reached. Retry after a short wait.
`rate_limit_store_unavailable`	503	Rate limiting is temporarily unavailable. Retry shortly.

A missing or unknown key returns 401 with a plain sentence in error rather than a code.

Requires a secret (sk_) key. A publishable key receives 403 secret_key_required.

Authentication

AuthorizationBearer

Send the API key as a Bearer token. Each operation states whether a publishable key is enough or a secret key is required.

Path parameters

jobIdstringRequired

The jobId returned when the triage job was accepted.

Response

Success

jobobject

distributionobject

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

503

Service Unavailable Error