List Location Transfers
GET/api/v2/location-transfers
Paginated history of location transfers (put-aways and relocations).
Authentication: Requires Bearer token.
Search: filter[search] matches transfer number, notes, warehouse name, and performing user's name; narrow with search_columns.
Operator-aware filters: filter[number], filter[notes] (text), filter[id] (numeric), filter[completed_at], filter[created_at] (datetime). Each supports a bare implicit-is form (filter[number]=LT-000012) and an operator form (filter[number.contains]=LT). Text operators: is, is_not, contains, does_not_contain, starts_with, does_not_start_with, ends_with, does_not_end_with, is_one_of, is_not_one_of, is_empty, is_not_empty. Numeric operators: is, is_not, greater_than, less_than, greater_than_or_equal, less_than_or_equal, between, is_one_of, is_not_one_of, is_empty, is_not_empty. Datetime operators: is, is_not, before, after, on_or_before, on_or_after, between, is_empty, is_not_empty.
Exact filters: filter[warehouse_id], filter[reason] (put_away | relocation), filter[product_id] (matches transfers containing a line for the product), filter[performed_by_user_id], filter[date_from] / filter[date_to] (date range on completion date, Y-m-d).
filter_groups accepts a base64-encoded JSON tree of AND/OR advanced filter groups and takes precedence over individual filter params.
Allowed sorts: id, number, reason, completed_at, created_at (default -completed_at).
Each row includes the warehouse, the performing user, and a lines_count. Line detail is returned by the single-transfer endpoint.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.