Skip to main content

List Resolutions

List resolution runs that apply field normalization, lookup cascades, and value transforms to extracted data. Supports cursor-based pagination.

Resolution runs apply field normalization, lookup cascades, and value transforms to extracted data. Create a resolution from a completed job run to standardise field values against reference data.

GET/v1/resolutions

Response

Response fields

dataarrayArray of resolution run objects.
data[].idstringResolution run UUID.
data[].source_run_idstringUUID of the originating job run.
data[].statusstringRun status: pending, running, completed, or failed.
data[].policy_snapshotobject | nullResolution policy configuration captured at run time.
data[].dialect_snapshotobject | nullDialect configuration captured at run time.
data[].error_messagestring | nullError detail if the run failed.
data[].created_atstringISO 8601 creation timestamp.
data[].updated_atstringISO 8601 last update timestamp.
data[].linksobjectRelated resource URLs (self, results, source_run).

Response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "source_run_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "status": "completed",
      "policy_snapshot": null,
      "dialect_snapshot": null,
      "error_message": null,
      "created_at": "2024-09-14T10:32:00.000Z",
      "updated_at": "2024-09-14T10:35:42.000Z",
      "links": {
        "self": "/v1/resolutions/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "results": "/v1/resolutions/a1b2c3d4-e5f6-7890-abcd-ef1234567890/results",
        "source_run": "/v1/jobs/b2c3d4e5-f6a7-8901-bcde-f12345678901"
      }
    }
  ]
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.