Skip to main content
GET
Get Return Request
Retrieve a return request, including any return labels issued for it.
Each entry in label_urls is a signed URL that expires after 7 days. Re-fetch the return to refresh the URLs if a customer hasn’t downloaded the label in that window.

Authorizations

Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

authorization
string | null

Path Parameters

return_request_id
string<uuid>
required

Response

Successful Response

id
string<uuid>
required
order_id
string<uuid>
required
status
enum<string>
required
Available options:
open,
approved,
denied,
credited
reason
enum<string>
required

Universal return reason codes (Shopify + Amazon prepaid alignment).

Available options:
damaged,
not_delivered,
empty_box,
wrong_item,
defective,
not_as_described,
wrong_size,
no_longer_needed,
forced_cancellation,
other
notes
string | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
resolution_notes
string | null
items
ReturnRequestItem · object[]
label_urls
string[]
merchant_return_id
string | null