Skip to main content
GET
/
v1
/
orders
/
{request_id}
Retrieve Order
curl --request GET \
  --url https://api.zinc.io/v1/orders/{request_id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "_type": "order_response",
  "price_components": {
    "converted_payment_total": 123,
    "currency": "<string>",
    "payment_currency": "<string>",
    "shipping": 123,
    "subtotal": 123,
    "tax": 123,
    "total": 123
  },
  "merchant_order_ids": [
    {
      "merchant_order_id": "<string>",
      "merchant": "<string>",
      "account": "<string>",
      "placed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "tracking": [
    {
      "product_id": "<string>",
      "merchant_order_id": "<string>",
      "carrier": "<string>",
      "tracking_number": "<string>",
      "obtained_at": "2023-11-07T05:31:56Z"
    }
  ],
  "request": {},
  "delivery_dates": "<array>",
  "account_status": {
    "prime": true,
    "fresh": true,
    "business": true,
    "charity": "<string>"
  }
}
Check order status using the request_id from your order request.
Processing Time: Orders typically take time to process. During processing, you’ll receive request_processing responses.
Possible responses:
  • Success: Order details with merchant order IDs, tracking, and pricing
  • Processing: Error response with request_processing code
  • Failed: Error response with specific error code
See Error Handling for complete error code reference.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
request_id
string
required

The unique identifier for the order request

Response

Order details retrieved successfully

​
_type
enum<string>

Response type

Available options:
order_response
​
price_components
object
​
merchant_order_ids
object[]

A merchant order ids object which contains details about the retailer's order identifiers

​
tracking
object[]

An array of tracking objects that contain the order's tracking information

​
request
object

The original request that was sent to the Zinc API

​
delivery_dates
array

An array of ordered products and their given delivery dates

​
account_status
object

(Amazon only) An account status object that gives details about the ordering account