> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Warehouse Sync Runs

> Recent runs with row counts and import progress

Lists runs from the last 30 days, newest first. Requires `warehouse:read`.

* `rowsUnchanged`: rows skipped because they did not change since they were last sent.
* `rowsSkipped`: rows missing required values, or events for contacts that do not exist yet. They are read again when the row changes, on a full resync, or on every run for syncs without a cursor column.
* `rowsFailed`: rows Sequenzy could not write this time. The cursor stays at the first of them, so the next run reads them again. A row that keeps failing where the previous run stopped is skipped with a note in `errorSamples`; a full resync sends it again.
* `errorSamples`: up to 20 examples with the row number in the query result.
* `imports`: progress of the subscriber imports the run queued. A run finishes when its rows are queued; imports can still be processing.

<ParamField path="id" type="string" required>
  Sync ID.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Between 1 and 100.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/warehouse-syncs/wsync_abc123/runs?limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "runs": [
      {
        "id": "wrun_1",
        "syncId": "wsync_abc123",
        "status": "succeeded",
        "isManual": false,
        "isFullResync": false,
        "rowsRead": 1204,
        "rowsUnchanged": 1100,
        "rowsSynced": 98,
        "rowsSkipped": 6,
        "rowsFailed": 0,
        "errorSamples": [
          {
            "row": 17,
            "reason": "Missing email"
          }
        ],
        "subscriberImportIds": [
          "imp_1"
        ],
        "imports": [
          {
            "id": "imp_1",
            "status": "completed",
            "totalRows": 98,
            "processedCount": 98,
            "addedCount": 12,
            "updatedCount": 86,
            "skippedCount": 0,
            "failedCount": 0
          }
        ],
        "error": null,
        "startedAt": "2026-09-30T12:00:00.000Z",
        "finishedAt": "2026-09-30T12:00:41.000Z"
      }
    ]
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "code": "not_found",
    "error": "Warehouse sync not found."
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.