---
title: "List IDR runs"
method: GET
path: "/idr/{graphId}/runs"
---

# List IDR runs

`GET /idr/{graphId}/runs`

List runs for a given IDR graph

## Path parameters

- `graphId` string, required

## Query parameters

- `runId` string
- `after` string, date-time
- `before` string, date-time
- `limit` number, double
- `offset` number, double
- `orderBy` 'created_at' | 'started_at' | 'finished_at'

## Response `200`

Ok

- ListIdrRunsOutput — The output of a request to list runs for an IDR graph.
  - `data` IdrRun[], required
    - `fullRerun` boolean, required
    - `stats` IdrRunStatsByThreshold
      - `probabilistic-loose` IdrRunStats
        - `numSourceRows` number, double, required — The exact number of rows processed from sources in this run.
        - `numNewUniqueProfiles` number, double, required — The exact number of unique profiles in the graph created during this run.
        - `numUniqueProfiles` number, double, required — The exact number of unique profiles in the graph at the end of the run.
      - `probabilistic-strict` IdrRunStats
        - `numSourceRows` number, double, required — The exact number of rows processed from sources in this run.
        - `numNewUniqueProfiles` number, double, required — The exact number of unique profiles in the graph created during this run.
        - `numUniqueProfiles` number, double, required — The exact number of unique profiles in the graph at the end of the run.
      - `deterministic` IdrRunStats
        - `numSourceRows` number, double, required — The exact number of rows processed from sources in this run.
        - `numNewUniqueProfiles` number, double, required — The exact number of unique profiles in the graph created during this run.
        - `numUniqueProfiles` number, double, required — The exact number of unique profiles in the graph at the end of the run.
    - `finishedAt` string, date-time — Timestamp of the run's completion. Only set for successful or failed runs.
    - `startedAt` string, date-time — Timestamp of the run's start. Not set for queued runs.
    - `createdAt` string, date-time, required
    - `error` string — If available, the error associated with a failed status.
    - `status` 'QUEUED' | 'PROCESSING' | 'SUCCESS' | 'FAILURE' | 'CANCELLED', required
    - `graphId` string, required
    - `id` string, required
  - `hasMore` boolean, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Failed

---

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