---
title: "Changes to Get list of transfers. Optional use the transferId parameter to only get one item."
method: GET
path: "/transfer"
---

# Changes to Get list of transfers. Optional use the transferId parameter to only get one item.

`GET /transfer`

> Every recorded change to this endpoint, newest first.
> 50 revisions in range; 3 not diffed.

## Timeline

Changed in 8 of 50 revisions.

- **2025-04-17** `9a5635ddf5b0` — 1 info
- **2025-02-18** `6459839250ee` — 6 warning, 7 info
- **2025-02-17** `492f60bedd9e` — 1 warning, 1 info
- **2025-02-17** `a56233f72c18` — 1 breaking, 1 info
- **2025-02-14** `23697c413be7` — 4 warning, 2 info
- **2025-02-14** `d08e48781d8e` — 8 info
- **2025-02-10** `9782fadb8c8d` — 2 breaking
- **2025-02-04** `80e97056c221` — 2 breaking, 5 warning, 6 info

## Changes

- **2025-04-17** `9a5635ddf5b0` — 1 info
  - added the new optional `header` request parameter `Scicat-API-Token`
- **2025-02-18** `6459839250ee` — 6 warning, 7 info
  - added the new `cancelled` enum value to the `transfers/items/status` response property for the response status `200`
  - added the new `failed` enum value to the `transfers/items/status` response property for the response status `200`
  - added the new `finished` enum value to the `transfers/items/status` response property for the response status `200`
  - added the new `invalid status` enum value to the `transfers/items/status` response property for the response status `200`
  - added the new `transferring` enum value to the `transfers/items/status` response property for the response status `200`
  - added the new `waiting` enum value to the `transfers/items/status` response property for the response status `200`
  - added the optional property `transfers/items/bytesTotal` to the response with the `200` status
  - added the optional property `transfers/items/bytesTransferred` to the response with the `200` status
  - added the optional property `transfers/items/filesTotal` to the response with the `200` status
  - added the optional property `transfers/items/filesTransferred` to the response with the `200` status
  - added the optional property `transfers/items/message` to the response with the `200` status
  - the response property `transfers/items/status` became required for the status `200`
  - the response property `transfers/items/transferId` became required for the status `200`
- **2025-02-17** `492f60bedd9e` — 1 warning, 1 info
  - added the new `invalid status` enum value to the `transfers/items/status` response property for the response status `200`
  - removed the `invalid state` enum value from the `transfers/items/status` response property for the response status `200`
- **2025-02-17** `a56233f72c18` — 1 breaking, 1 info
  - removed the required property `transfers/items/state` from the response with the `200` status
  - added the required property `transfers/items/status` to the response with the `200` status
- **2025-02-14** `23697c413be7` — 4 warning, 2 info
  - removed the optional property `transfers/items/failed` from the response with the `200` status
  - removed the optional property `transfers/items/finished` from the response with the `200` status
  - removed the optional property `transfers/items/started` from the response with the `200` status
  - removed the optional property `transfers/items/status` from the response with the `200` status
  - added the optional property `transfers/items/message` to the response with the `200` status
  - added the required property `transfers/items/state` to the response with the `200` status
- **2025-02-14** `d08e48781d8e` — 8 info
  - added the optional property `transfers/items/bytesTotal` to the response with the `200` status
  - added the optional property `transfers/items/bytesTransferred` to the response with the `200` status
  - added the optional property `transfers/items/failed` to the response with the `200` status
  - added the optional property `transfers/items/filesTotal` to the response with the `200` status
  - added the optional property `transfers/items/filesTransferred` to the response with the `200` status
  - added the optional property `transfers/items/finished` to the response with the `200` status
  - added the optional property `transfers/items/started` to the response with the `200` status
  - the response property `transfers/items/transferId` became required for the status `200`
- **2025-02-10** `9782fadb8c8d` — 2 breaking
  - for the `query` request parameter `page`, the format changed from no format to `uint`
  - for the `query` request parameter `pageSize`, the format changed from no format to `uint`
- **2025-02-04** `80e97056c221` — 2 breaking, 5 warning, 6 info
  - the response property `transfers/items/status` became optional for the status `200`
  - the response property `transfers/items/transferId` became optional for the status `200`
  - removed the optional property `transfers/items/bytesTotal` from the response with the `200` status
  - removed the optional property `transfers/items/bytesTransferred` from the response with the `200` status
  - removed the optional property `transfers/items/filesTotal` from the response with the `200` status
  - removed the optional property `transfers/items/filesTransferred` from the response with the `200` status
  - removed the optional property `transfers/items/message` from the response with the `200` status
  - removed the `cancelled` enum value from the `transfers/items/status` response property for the response status `200`
  - removed the `failed` enum value from the `transfers/items/status` response property for the response status `200`
  - removed the `finished` enum value from the `transfers/items/status` response property for the response status `200`
  - removed the `invalid status` enum value from the `transfers/items/status` response property for the response status `200`
  - removed the `transferring` enum value from the `transfers/items/status` response property for the response status `200`
  - removed the `waiting` enum value from the `transfers/items/status` response property for the response status `200`

---

[Operation](https://skmtc.dev/swissopenem/apis/scicat-ingestor-api/docs/transfer/get.md) · [API](https://skmtc.dev/swissopenem/apis/scicat-ingestor-api.md) · [Page](https://skmtc.dev/swissopenem/apis/scicat-ingestor-api/changes/transfer/get)