Skip to main content
GET
List Return Requests
Retrieve every return request you’ve filed, sorted newest first.

Response

An object with a return_requests array. Each entry has the same shape as Get Return Request — see that page for the full field list.

Return Request Statuses

approved, denied, and credited are all terminal states. Once a return reaches one of them, it won’t change again.

Authorizations

Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

authorization
string | null

Query Parameters

limit
integer
default:50

Page size (default 50, max 500). Responses include total for paging past it.

Required range: 1 <= x <= 500
offset
integer
default:0

Number of returns to skip

Required range: x >= 0
search
string | null

Partial match on order ID

status
string | null

Filter by return status

Response

Successful Response

return_requests
ReturnRequestResponse · object[]
required
total
integer
required