---
title: "List warehouse sync runs"
method: GET
path: "/warehouse-syncs/{id}/runs"
tags: ["Warehouse Sync"]
---

# List warehouse sync runs

`GET /warehouse-syncs/{id}/runs`

## Request

- Base URL: `https://api.sequenzy.com/api/v1`
- URL: `https://api.sequenzy.com/api/v1/warehouse-syncs/{id}/runs`
- Auth: HTTP bearer

Lists runs from the last 30 days, newest first, with row counts, sample row problems and import progress.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer

## Response `200`

Runs returned

- object
  - `success` boolean
  - `runs` WarehouseSyncRun[]
    - `id` string
    - `syncId` string
    - `status` 'running' | 'succeeded' | 'failed'
    - `isManual` boolean
    - `isFullResync` boolean
    - `rowsRead` integer
    - `rowsUnchanged` integer: Rows skipped because they did not change since they were last sent.
    - `rowsSynced` integer
    - `rowsSkipped` integer: Rows missing required values, or events for unknown contacts. Read again when the row changes, on a full resync, or on every run without a cursor column.
    - `rowsFailed` integer: Rows Sequenzy could not write this time. The cursor stays at the first of them, so the next run reads them again.
    - `errorSamples` object[]
      - `row` integer
      - `reason` string
    - `subscriberImportIds` string[]
    - `imports` object[]: Progress of the subscriber imports this run queued.
      - `id` string
      - `status` string
      - `totalRows` integer
      - `processedCount` integer
      - `addedCount` integer
      - `updatedCount` integer
      - `skippedCount` integer
      - `failedCount` integer
    - `error` string, nullable
    - `startedAt` string, date-time
    - `finishedAt` string, date-time, nullable

## Other responses

- `401`: Unauthorized
- `403`: Missing scope, or the member role cannot manage workspace settings
- `404`: Not found

## Changes

- **2026-10-16** `db3873ca3d4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/warehouse-syncs/:id/runs/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) - [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequenzy/apis/sequenzy-api/revisions/8156dc12d8b4?raw)
