Retrieve Order
curl --request GET \
--url https://api.zinc.io/v1/orders/{request_id} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.zinc.io/v1/orders/{request_id}"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.zinc.io/v1/orders/{request_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zinc.io/v1/orders/{request_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.zinc.io/v1/orders/{request_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.zinc.io/v1/orders/{request_id}")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zinc.io/v1/orders/{request_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"_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>"
}
}{
"_type": "error",
"code": "<string>",
"message": "<string>",
"data": {}
}Orders
Retrieve Order
Get the status of an order from the order request_id
GET
/
v1
/
orders
/
{request_id}
Retrieve Order
curl --request GET \
--url https://api.zinc.io/v1/orders/{request_id} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.zinc.io/v1/orders/{request_id}"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.zinc.io/v1/orders/{request_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zinc.io/v1/orders/{request_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.zinc.io/v1/orders/{request_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.zinc.io/v1/orders/{request_id}")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zinc.io/v1/orders/{request_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"_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>"
}
}{
"_type": "error",
"code": "<string>",
"message": "<string>",
"data": {}
}Check order status using the
Possible responses:
request_id from your order request.
Processing Time: Orders typically take time to process. During processing, you’ll receive
request_processing responses.- Success: Order details with merchant order IDs, tracking, and pricing
- Processing: Error response with
request_processingcode - Failed: Error response with specific error code
See Error Handling for complete error code reference.
Authorizations
Use your client token as the username. Leave the password blank.
Path Parameters
The unique identifier for the order request
Response
Order details retrieved successfully
Response type
Available options:
order_response Show child attributes
Show child attributes
A merchant order ids object which contains details about the retailer's order identifiers
Show child attributes
Show child attributes
An array of tracking objects that contain the order's tracking information
Show child attributes
Show child attributes
The original request that was sent to the Zinc API
An array of ordered products and their given delivery dates
(Amazon only) An account status object that gives details about the ordering account
Show child attributes
Show child attributes

