Help CenterGitHub

List return labels

Returns a list of return shipping labels.

Parameters

Query Parameters

page integer
Page number for pagination
limit integer
Items per page (max 100)
status string (PURCHASED | IN_TRANSIT | DELIVERED | VOIDED)
Filter by return label status
carrier string (USPS | FEDEX | UPS | DHL | CANADA_POST)
Filter by carrier

Returns

200 List of return labels retrieved successfully
401 Authentication required

Related

Returns
GET/api/v1/returns
atoship © 2026