POST
/
v1
/
orders
/
{order_id}
/
case
Create or Update Case
curl --request POST \
  --url https://api.zinc.io/v1/orders/{order_id}/case \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "reason": "return.request_label",
  "message": "<string>"
}'
{
  "state": "open",
  "messages": [
    {
      "type": "case.opened.return.request_label",
      "message": "<string>",
      "timestamp": "2023-11-07T05:31:56Z"
    }
  ]
}
Cases are for Zinc Managed Account (ZMA) orders only. Self-managed account orders should handle issues directly with the retailer.
In some cases, a Managed Account order might initially succeed (and thus charge your account) but later need to be reversed. For example, your buyer might want to return the product, or the order may be cancelled by the Amazon seller. Cases are automatically opened by Zinc when an order is cancelled, a return is requested, and for other scenarios. You can also open a Case to ask for assistance with a failed return, cancellation, and other issues. Cases are regularly updated by Zinc with information about the status of the case.

Authorizations

​
Authorization
string
header
required

Use your client token as the username. Leave the password blank.

Path Parameters

​
order_id
string
required

The order ID to create or update a case for

Body

application/json

Response

200 - application/json

Case created or updated successfully

The response is of type object.