Get Resolution

Retrieve a resolution run by ID with its current status, document count, completion timestamp, and links to results. Requires read scope for the workspace.

Retrieve the current status and metadata of a specific resolution run. Use this endpoint to poll for completion after executing a resolution. The response includes links to the results endpoint where you can inspect per-field resolved values.

GET/v1/resolutions/{id}

Response

Response fields

idstringResolution run UUID.

source_run_idstringUUID of the originating job run.

statusstringRun status: pending, running, completed, or failed.

policy_snapshotobject | nullResolution policy configuration captured at run time.

dialect_snapshotobject | nullDialect configuration captured at run time.

error_messagestring | nullError detail if the run failed.

created_atstringISO 8601 creation timestamp.

updated_atstringISO 8601 last update timestamp.

linksobjectRelated resource URLs (self, results, source_run).

Response

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

This endpoint is typically used in a polling loop after calling POST /v1/resolutions/{id}/execute. Watch for status transitioning from running to completed or failed. Once completed, use GET /v1/resolutions/{id}/results to inspect per-field resolved values and the resolution_step that produced each canonical mapping.

Errors

Error responses

401unauthorizedMissing or invalid API key.

404not_foundResolution run not found or does not belong to your organization.

429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

List Resolutions

Get Resolution Results