---
title: "List transfers"
method: GET
path: "/transfers"
tags: ["Transfers"]
---

# List transfers

`GET /transfers`

Retrieve list of transfers.

## Query parameters

- `destination_id` string
- `status` string
- `include_tags` string
- `ended_before` string
- `ended_after` string
- `page_size` integer
- `order` 'asc' | 'desc'
- `cursor` string

## Response `200`

OK

- object
  - `status` 'success', required
  - `data` ListTransferResponse, required
    - `transfers` Transfer[], required
      - `id` string, required — Unique identifier for the transfer.
      - `source_ids` string[] — IDs of the sources used in this transfer.
      - `destination_id` string — ID of the destination this transfer wrote to.
      - `status` 'PENDING' | 'RUNNING' | 'SUCCESS' | 'PARTIAL_FAILURE' | 'ERROR' | 'CANCELLED' | 'KILLED' | 'EXPIRED' | 'ORPHANED', required — Current status of the transfer.
      - `is_full_refresh` boolean, required — Whether this transfer was a full refresh (true) or incremental (false).
      - `models` string[], required — Names of the models included in this transfer.
      - `model_metrics` ModelMetrics[] — Per-model object of results including row counts and any errors. — unresolved $ref
      - `log` string, required — Plain text description of the model results.
      - `submitted_at` string, date-time, required — When the transfer was submitted to the queue.
      - `start_transfer_window_at` string, date-time, required — Start of the transfer window.
      - `end_transfer_window_at` string, date-time, required — End of the transfer window.
      - `started_at` string, date-time — When the transfer began executing.
      - `ended_at` string, date-time — When the transfer finished executing.
      - `rows_transferred` integer, required — Total number of rows written to the destination across all models.
      - `delta_rows_transferred` integer, required — Estimate of net change in row count at the destination.
      - `volume_transferred_in_mb` number, required — Total data volume written to the destination in megabytes.
      - `tags` object — Arbitrary key-value string tags attached to the transfer.
      - `actor_id` string, required — ID of the actor that triggered this transfer.
      - `actor_type` 'unknown' | 'user' | 'api_key' | 'service' | 'recipient', required — Type of actor that triggered this transfer.
  - `message` string, required
  - `has_next` boolean, required — Whether there are more items beyond this page.
  - `next_url` string — Full URL to fetch the next page. Only present when has_next is true.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/prequel/apis/prequel-data-export.md) · [All operations](https://skmtc.dev/prequel/apis/prequel-data-export/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prequel/prequel-data-export/revisions/09c662a871f8/schema)