List warehouse transfers

Operation ID: warehouseTransfers

Group: Inventory › Warehouse Transfers

Open in the interactive reference

GET /inventory/warehouse-transfers

Read-only: Reads and returns; changes nothing.

Lists warehouse transfers. Each transfer comes back without its lines, with lineCount instead. Every other field matches GET inventory/warehouse-transfers/:id.

To find intercompany transfers that are committed but not billed, filter on transferType 'INTERCOMPANY', documentStatus 'COMMITTED' and billingStatus 'NOT_BILLED'.

To filter by item, use POST inventory/warehouse-transfers/search.

Parameters

Query surface

• id — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• documentNumber — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• documentStatus — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• documentDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• transferType — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• entityId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• toEntityId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• locationId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• targetLocationId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• billingStatus — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• lastModifiedDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• Orderable: id, documentNumber, documentDate, documentStatus, transferType, createdDate, lastModifiedDate
• Selectable: id, documentNumber, documentStatus, documentDate, referenceNumber, transferType, entityId, entityName, toEntityId, toEntityName, locationId, locationCode, locationName, targetLocationId, targetLocationCode, targetLocationName, billingStatus, intercompanyBillId, contractualCurrency, currency, sourceAmount, destinationCurrency, destinationAmount, notes, lineCount, createdDate, lastModifiedDate
• page[size] — Page size
• page[cursor] — Opaque continuation cursor

Response

200 Success

Under data, an array of warehouseTransfersRow:

{
  "data": [
    {
      "id": "c41f9a08-6b23-4e57-90d8-2f7a5c31e0b6",
      "documentNumber": "WTR-2291",
      "documentStatus": "DRAFT",
      "documentDate": "2026-08-18",
      "referenceNumber": "<referenceNumber>",
      "transferType": "NORMAL",
      "entityId": "1a9c4e70-38b5-4d26-9f01-7c2e5b8a6d43",
      "entityName": "Acme Netherlands B.V.",
      "toEntityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "toEntityName": "<toEntityName>",
      "locationId": "b6f0d2a4-77c1-4e39-8a52-0c4e1f9b73d5",
      "locationCode": "WH-CENTRAL",
      "locationName": "Central warehouse",
      "targetLocationId": "e94a17c3-5b28-4d60-91f7-3a8c2e05b6d1",
      "targetLocationCode": "WH-NORTH",
      "targetLocationName": "Northern depot",
      "billingStatus": "<billingStatus>",
      "intercompanyBillId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "contractualCurrency": "<contractualCurrency>",
      "currency": "EUR",
      "sourceAmount": "19.99",
      "destinationCurrency": "<destinationCurrency>",
      "destinationAmount": "19.99",
      "notes": "<notes>",
      "lineCount": 1,
      "createdDate": "2026-08-18T09:14:22.104Z",
      "lastModifiedDate": "2026-08-18T09:14:22.517Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "<nextCursor>"
  }
}

Statuses

• 400 — Invalid request or business failure
• 401 — The request carries no valid access token.
• 403 — Not authorized
• 404 — Not found
• 429 — Too many requests from this client address. The response has no body and no Retry-After header.
• 500 — Internal server error