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",
      "notes": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "resolution_notes": "<string>",
      "items": [],
      "label_urls": [],
      "merchant_return_id": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://www.zinc.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

StatusDescription
openSubmitted, awaiting or in active processing
approvedReturn was approved and completed
deniedReturn request was denied
approved and denied are both terminal states. Once a return reaches either of them, it won’t change again.

Authorizations

​
Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

​
authorization
string | null

Response

Successful Response

​
return_requests
ReturnRequestResponse · object[]
required