List Returns
Get a paginated list of returns for the organization
Retrieves a paginated list of return requests for your organization. You can filter by status, source type, and search by return number, customer name, or email.
Parameters
Query Parameters
status
string
Filter by return status. Options: CREATED, LABEL_CREATED, SHIPPED, IN_TRANSIT, DELIVERED, INSPECTED, COMPLETED, CANCELLED
sourceType
string
Filter by source type. Options: LABEL, ORDER, MANUAL, SHOPIFY_SYNC
page
integer
Page number (default: 1)
limit
integer
Items per page (default: 50)
search
string
Search by return number, customer name, email, or tracking number
Returns
200
Returns list retrieved successfully
401
Unauthorized - authentication required
Related
returns
list
GET/api/returns