---
title: "Get a dispute service run by ID"
method: GET
path: "/dispute/disputes/runs/{runId}"
tags: ["Disputes"]
---

# Get a dispute service run by ID

`GET /dispute/disputes/runs/{runId}`

Retrieve a single dispute service run by its ID, including its execution attempts. A run that exists but belongs to a workspace you cannot access returns 404. Use this to inspect the outcome of a backfill, including its window, the disputes and payments it loaded, and any unsupported operations.

## Path parameters

- `runId` string, uuid, required

## Response `200`

Success.

- object — An asynchronous run in the dispute service. A run is created when an operation is enqueued (for example a backfill) and tracks its lifecycle and outcome. Status and resolution are derived from the run's latest execution attempt.
  - `id` string, uuid, required — Unique identifier of the run.
  - `workspaceId` string, uuid — Workspace the run belongs to. Omitted for runs that are not scoped to a single workspace.
  - `runType` string, required — The kind of work the run performs, for example `dispute-pull-controller` (owns the cursor for one provider configuration) or `dispute-pull-window` (pulls disputes and their related payments for one time window).
  - `status` 'queued' | 'dispatched' | 'done', required — Lifecycle state of the run.
  - `resolution` 'success' | 'failed' | 'cancelled' — Outcome of a completed run. Absent until the run reaches `done`.
  - `errors` string[] — Error messages collected during execution, when the run did not fully succeed.
  - `params` object — The arguments the run was started with. The shape depends on `runType`; a dispute-pull run carries `providerConfigId`, optional `paymentProviderConfigId`, and the `dateFrom` / `dateTo` window.
  - `summary` object — Aggregate result of the run. The shape depends on `runType`; a dispute-pull window reports `disputesPulled`, `disputesUpserted`, `paymentsPulled`, `paymentsUpserted` and any `unsupportedOps`.
  - `input` object — Trigger metadata for the run, such as the resolved window or cursor.
  - `parentRunId` string, uuid — For a child run, the identifier of the run that spawned it (for example a dispute-pull window's controller). Absent for top-level runs.
  - `startedAt` string, date-time — Date and time when the run started executing.
  - `completedAt` string, date-time — Date and time when the run finished. Absent until the run reaches `done`.
  - `createdAt` string, date-time, required — Date and time when the run was created.
  - `updatedAt` string, date-time, required — Date and time when the run was last updated.
  - `jobs` object[] — The run's execution attempts, most recent first. Included only when a single run is retrieved by id.
    - `id` string, uuid, required — Unique identifier of the run job.
    - `runId` string, uuid, required — Identifier of the run this attempt belongs to.
    - `eventId` string — Idempotency reference for the attempt.
    - `externalReference` string — Reference to the external execution backing this attempt, when applicable.
    - `status` 'queued' | 'dispatched' | 'done', required — Lifecycle state of the attempt.
    - `resolution` 'success' | 'failed' | 'cancelled' — Outcome of the attempt. Absent until the attempt reaches `done`.
    - `errors` string[] — Error messages collected during the attempt.
    - `summary` object — Aggregate result of the attempt; shape depends on the run type.
    - `input` object — Trigger metadata for the attempt, such as the resolved window or cursor.
    - `startedAt` string, date-time — Date and time when the attempt started executing.
    - `completedAt` string, date-time — Date and time when the attempt finished.
    - `createdAt` string, date-time, required — Date and time when the attempt was created.

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Insufficient Scope.
- `404` — Not Found.
- `429` — Too Many Requests.

---

[API](https://skmtc.net/payrails/apis/payrails-api-reference.md) · [All operations](https://skmtc.net/payrails/apis/payrails-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payrails/payrails-api-reference/revisions/9dd2f0158582/schema)