Skip to main content
GET
/
returns
List Return Requests
curl --request GET \
  --url https://api.zinc.com/returns \
  --header 'Authorization: <api-key>'
{
  "return_requests": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "open",
      "reason": "return.request_label",
      "notes": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}
Retrieve a list of all return requests associated with your account.

​
Response

Returns an object containing a return_requests array. Each return request includes:
  • id - Return request UUID
  • order_id - The associated order ID
  • status - Current return request status
  • reason - The reason for the return
  • notes - Any additional notes
  • created_at - Request creation timestamp
  • updated_at - Last update timestamp

​
Return Request Statuses

StatusDescription
openRequest submitted, awaiting review
in_progressReturn is being processed
approvedReturn has been approved
deniedReturn request was denied
completedReturn has been completed

Authorizations

​
Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

​
authorization
string | null

Response

Successful Response

​
return_requests
ReturnRequestResponse · object[]
required