List orders
curl --request GET \
--url https://api.dev.shadowchef.co/v1/partner/orders \
--header 'Authorization: Basic <encoded-value>'const url = 'https://api.dev.shadowchef.co/v1/partner/orders';
const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.dev.shadowchef.co/v1/partner/orders"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.dev.shadowchef.co/v1/partner/orders"
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))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dev.shadowchef.co/v1/partner/orders",
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;
}{
"request_id": "d4cc8bee50798956843cc19e0de6ba72",
"data": {
"orders": [
{
"additional_fee": 0,
"additional_fee_display": "0.000",
"additional_info": {
"vehicle_info": {}
},
"auto_accept": false,
"auto_ready": true,
"branch_id": 1293,
"brands": [
{
"id": 5297,
"logo": "/images/1a0cd999ecf8d62acb4f558ff8fb747ae5fe6b61.jpeg",
"title": "(DEMO) Cimol Bojot AA"
}
],
"business_id": 398,
"campaigns": [],
"can_accept": false,
"can_cancel": true,
"can_deliver": false,
"can_ready": false,
"can_void": true,
"cart": [
{
"brand": {
"id": 5297,
"logo": "/images/1a0cd999ecf8d62acb4f558ff8fb747ae5fe6b61.jpeg",
"title": "(DEMO) Cimol Bojot AA"
},
"comment": "",
"description": "Cimol Beef Porsi Besar Isi 14 Pcs",
"groups": [],
"image": "",
"item_final_price": 0,
"item_id": 289379,
"klikit_category_id": 39118,
"klikit_category_name": "Cimol Beef",
"klikit_id": 289379,
"klikit_name": "Cimol Beef Porsi Besar",
"klikit_price": 0,
"klikit_section_id": 6825,
"klikit_section_name": "Cimol Bojot AA Master Menu",
"klikit_sku_id": "CBA001",
"price": 0,
"promo_discount": 0,
"quantity": 1,
"title": "Cimol Beef Porsi Besar",
"title_v2": {
"en": "Cimol Beef Porsi Besar"
},
"unit_price": 0,
"vat": 0
}
],
"cart_v2": [
{
"brand": {
"id": 5297,
"logo": "/images/1a0cd999ecf8d62acb4f558ff8fb747ae5fe6b61.jpeg",
"title": "(DEMO) Cimol Bojot AA"
},
"description": "Cimol Beef Porsi Besar Isi 14 Pcs",
"id": "289379",
"klikit_category_id": 39118,
"klikit_category_name": "Cimol Beef",
"klikit_id": 289379,
"klikit_name": "Cimol Beef Porsi Besar",
"klikit_name_translation": {
"en": "Cimol Beef Porsi Besar"
},
"klikit_section_id": 6825,
"klikit_section_name": "Cimol Bojot AA Master Menu",
"klikit_sku_id": "CBA001",
"klikit_unit_price": "0.00",
"menu_version": 2,
"modifier_group_price": "0.00",
"modifier_groups": [],
"name": "Cimol Beef Porsi Besar",
"price": "0.00",
"price_display": "0.000",
"quantity": 1,
"unit_price": "0.00",
"unit_price_display": "0.000"
}
],
"created_at": "2026-06-24T12:03:27Z",
"created_by": 11745,
"created_by_user": "Tiwi Support Testing Account",
"currency": "IDR",
"currency_symbol": "Rp",
"delivery_address": "",
"delivery_fee": 0,
"delivery_info": null,
"discount": 0,
"external_id": "1782302607204811041",
"final_price": 0,
"final_price_display": "0.000",
"fulfillment_status_id": null,
"fulfillments": [],
"id": 71280866,
"identity": "e8481d02-550f-44b1-b489-e7b941b8c2f5",
"is_manual_order": true,
"is_offline_payment": true,
"is_vat_included": true,
"item_count": 1,
"item_price": 0,
"klikit_store_id": "KSID-5297-1293",
"order_comment": "",
"order_status_histories": [
{
"id": 253820147,
"order_id": 71280866,
"status": 1,
"processed_at": "2026-06-24T12:03:27Z",
"updated_by": null
},
{
"id": 253820195,
"order_id": 71280866,
"status": 2,
"processed_at": "2026-06-24T12:03:35Z",
"updated_by": null
},
{
"id": 253820300,
"order_id": 71280866,
"status": 4,
"processed_at": "2026-06-24T12:03:49Z",
"updated_by": null
},
{
"id": 253820409,
"order_id": 71280866,
"status": 5,
"processed_at": "2026-06-24T12:04:02Z",
"updated_by": null
}
],
"payment_channel_id": 39,
"payment_method": 1,
"payment_status": 1,
"preparation_time": 10,
"provider_id": 1,
"qr_code_url": "https://me.klikit.io/order/AAAAAAQ_qOIAAAAAajz3yaRvUcUfMoHEBxwoEEfLqsU",
"short_id": "1004",
"source": 9,
"status": 5,
"type": 3,
"unique_item_count": 1,
"updated_at": "2026-06-24T12:04:02Z",
"user_full_name": "Tiwi Support Testing Account",
"vat": 0
},
{
"branch_id": 5913,
"brands": [
{
"id": 1100,
"logo": "/images/977d6c49b04755746ebb77056f6aee1849a9d8b1.png",
"title": "TEST - Klikit Healthy Kitchen"
}
],
"business_id": 398,
"cancellation_reason": "Maxim cancelled",
"cancelled_by": 3,
"can_accept": false,
"can_cancel": true,
"can_deliver": true,
"can_ready": true,
"can_void": false,
"cart_v2": [
{
"brand": {
"id": 1100,
"logo": "/images/977d6c49b04755746ebb77056f6aee1849a9d8b1.png",
"title": "TEST - Klikit Healthy Kitchen"
},
"id": "43014",
"klikit_id": 43014,
"klikit_category_name": "Menu Satuan",
"klikit_section_name": "Klikit Dimsum",
"name": "Dimsum Cumi",
"quantity": 2,
"price": "13000.00",
"unit_price": "6500.00",
"unit_price_display": "6.500"
}
],
"created_at": "2026-06-24T10:10:14Z",
"currency": "IDR",
"delivery_fee": 730000,
"delivery_fee_display": "7.300",
"delivery_info": {
"address": "Fakultas Bahasa dan Seni Universitas Pendidikan Ganesha, Jl. A. Yani, Kaliuntu, Buleleng, Buleleng, Bali, Indonesia, 81116",
"coordinates": {
"latitude": -8.1121781,
"longitude": 115.085482
},
"email": "[email protected]",
"first_name": "Rezal",
"last_name": "Rezal",
"phone": "+6282155213518"
},
"external_id": "bfb76006-835c-4d61-a789-b3a0afd6d5fc",
"final_price": 1300000,
"final_price_display": "13.000",
"fulfillment_status_id": 9,
"fulfillments": [
{
"delivery_fee": 730000,
"fulfillment_provider_id": 5,
"order_id": 71269954,
"sequence": 1,
"status_id": 9,
"receiver": {
"address": "Fakultas Bahasa dan Seni Universitas Pendidikan Ganesha, Jl. A. Yani, Kaliuntu, Buleleng, Buleleng, Bali, Indonesia, 81116",
"coordinates": {
"latitude": -8.1121781,
"longitude": 115.085482
},
"first_name": "Rezal",
"phone": "+6282155213518"
},
"sender": {
"address": "Jl. Pahlawan, Paket Agung, Kec. Buleleng, Kabupaten Buleleng, Bali 81117",
"coordinates": {
"latitude": -8.124293388269452,
"longitude": 115.0929023057558
},
"country_code": "ID",
"first_name": "TEST - Klikit Healthy Kitchen, Branch: (DEMO) Buleleng",
"phone": "+6285172191644"
}
}
],
"id": 71269954,
"identity": "268053",
"is_manual_order": false,
"is_offline_payment": false,
"item_count": 2,
"item_price": 1300000,
"max_preparation_time": 60,
"order_status_histories": [
{
"id": 253780790,
"order_id": 71269954,
"status": 2,
"processed_at": "2026-06-24T10:10:49Z"
},
{
"id": 253785511,
"order_id": 71269954,
"status": 3,
"processed_at": "2026-06-24T10:25:50Z"
}
],
"payment_channel_id": 49,
"payment_method": 18,
"payment_status": 1,
"preparation_time": 20,
"provider_grand_total": 2030000,
"provider_grand_total_display": "20.300",
"provider_id": 17,
"provider_sub_total": 1300000,
"provider_sub_total_display": "13.000",
"short_id": "1002",
"source": 0,
"status": 3,
"type": 2,
"unique_item_count": 1,
"updated_at": "2026-06-24T10:25:50Z",
"user_email": "[email protected]",
"user_first_name": "Rezal",
"user_id": 160888,
"user_last_name": "Rezal",
"user_phone": "+6282155213518"
}
],
"page": 1,
"size": 2,
"total": 50
}
}{
"request_id": "req_4d1b7e3f-...",
"data": "<unknown>",
"error": {
"code": "request_invalid",
"message": "<string>",
"details": "<unknown>"
}
}{
"request_id": "req_4d1b7e3f-...",
"data": "<unknown>",
"error": {
"code": "auth_invalid_credential",
"message": "<string>",
"details": "<unknown>"
}
}{
"request_id": "req_4d1b7e3f-...",
"data": "<unknown>",
"error": {
"code": "auth_invalid_credential",
"message": "<string>",
"details": "<unknown>"
}
}{
"request_id": "req_4d1b7e3f-...",
"data": "<unknown>",
"error": {
"code": "rate_limit_exceeded",
"message": "<string>",
"details": "<unknown>"
}
}orders
List orders
Paginated, reverse-chronological order list scoped to your credential’s business. Supports filtering by date range, status, provider and branch.
GET
/
v1
/
partner
/
orders
List orders
curl --request GET \
--url https://api.dev.shadowchef.co/v1/partner/orders \
--header 'Authorization: Basic <encoded-value>'const url = 'https://api.dev.shadowchef.co/v1/partner/orders';
const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.dev.shadowchef.co/v1/partner/orders"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.dev.shadowchef.co/v1/partner/orders"
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))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dev.shadowchef.co/v1/partner/orders",
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;
}{
"request_id": "d4cc8bee50798956843cc19e0de6ba72",
"data": {
"orders": [
{
"additional_fee": 0,
"additional_fee_display": "0.000",
"additional_info": {
"vehicle_info": {}
},
"auto_accept": false,
"auto_ready": true,
"branch_id": 1293,
"brands": [
{
"id": 5297,
"logo": "/images/1a0cd999ecf8d62acb4f558ff8fb747ae5fe6b61.jpeg",
"title": "(DEMO) Cimol Bojot AA"
}
],
"business_id": 398,
"campaigns": [],
"can_accept": false,
"can_cancel": true,
"can_deliver": false,
"can_ready": false,
"can_void": true,
"cart": [
{
"brand": {
"id": 5297,
"logo": "/images/1a0cd999ecf8d62acb4f558ff8fb747ae5fe6b61.jpeg",
"title": "(DEMO) Cimol Bojot AA"
},
"comment": "",
"description": "Cimol Beef Porsi Besar Isi 14 Pcs",
"groups": [],
"image": "",
"item_final_price": 0,
"item_id": 289379,
"klikit_category_id": 39118,
"klikit_category_name": "Cimol Beef",
"klikit_id": 289379,
"klikit_name": "Cimol Beef Porsi Besar",
"klikit_price": 0,
"klikit_section_id": 6825,
"klikit_section_name": "Cimol Bojot AA Master Menu",
"klikit_sku_id": "CBA001",
"price": 0,
"promo_discount": 0,
"quantity": 1,
"title": "Cimol Beef Porsi Besar",
"title_v2": {
"en": "Cimol Beef Porsi Besar"
},
"unit_price": 0,
"vat": 0
}
],
"cart_v2": [
{
"brand": {
"id": 5297,
"logo": "/images/1a0cd999ecf8d62acb4f558ff8fb747ae5fe6b61.jpeg",
"title": "(DEMO) Cimol Bojot AA"
},
"description": "Cimol Beef Porsi Besar Isi 14 Pcs",
"id": "289379",
"klikit_category_id": 39118,
"klikit_category_name": "Cimol Beef",
"klikit_id": 289379,
"klikit_name": "Cimol Beef Porsi Besar",
"klikit_name_translation": {
"en": "Cimol Beef Porsi Besar"
},
"klikit_section_id": 6825,
"klikit_section_name": "Cimol Bojot AA Master Menu",
"klikit_sku_id": "CBA001",
"klikit_unit_price": "0.00",
"menu_version": 2,
"modifier_group_price": "0.00",
"modifier_groups": [],
"name": "Cimol Beef Porsi Besar",
"price": "0.00",
"price_display": "0.000",
"quantity": 1,
"unit_price": "0.00",
"unit_price_display": "0.000"
}
],
"created_at": "2026-06-24T12:03:27Z",
"created_by": 11745,
"created_by_user": "Tiwi Support Testing Account",
"currency": "IDR",
"currency_symbol": "Rp",
"delivery_address": "",
"delivery_fee": 0,
"delivery_info": null,
"discount": 0,
"external_id": "1782302607204811041",
"final_price": 0,
"final_price_display": "0.000",
"fulfillment_status_id": null,
"fulfillments": [],
"id": 71280866,
"identity": "e8481d02-550f-44b1-b489-e7b941b8c2f5",
"is_manual_order": true,
"is_offline_payment": true,
"is_vat_included": true,
"item_count": 1,
"item_price": 0,
"klikit_store_id": "KSID-5297-1293",
"order_comment": "",
"order_status_histories": [
{
"id": 253820147,
"order_id": 71280866,
"status": 1,
"processed_at": "2026-06-24T12:03:27Z",
"updated_by": null
},
{
"id": 253820195,
"order_id": 71280866,
"status": 2,
"processed_at": "2026-06-24T12:03:35Z",
"updated_by": null
},
{
"id": 253820300,
"order_id": 71280866,
"status": 4,
"processed_at": "2026-06-24T12:03:49Z",
"updated_by": null
},
{
"id": 253820409,
"order_id": 71280866,
"status": 5,
"processed_at": "2026-06-24T12:04:02Z",
"updated_by": null
}
],
"payment_channel_id": 39,
"payment_method": 1,
"payment_status": 1,
"preparation_time": 10,
"provider_id": 1,
"qr_code_url": "https://me.klikit.io/order/AAAAAAQ_qOIAAAAAajz3yaRvUcUfMoHEBxwoEEfLqsU",
"short_id": "1004",
"source": 9,
"status": 5,
"type": 3,
"unique_item_count": 1,
"updated_at": "2026-06-24T12:04:02Z",
"user_full_name": "Tiwi Support Testing Account",
"vat": 0
},
{
"branch_id": 5913,
"brands": [
{
"id": 1100,
"logo": "/images/977d6c49b04755746ebb77056f6aee1849a9d8b1.png",
"title": "TEST - Klikit Healthy Kitchen"
}
],
"business_id": 398,
"cancellation_reason": "Maxim cancelled",
"cancelled_by": 3,
"can_accept": false,
"can_cancel": true,
"can_deliver": true,
"can_ready": true,
"can_void": false,
"cart_v2": [
{
"brand": {
"id": 1100,
"logo": "/images/977d6c49b04755746ebb77056f6aee1849a9d8b1.png",
"title": "TEST - Klikit Healthy Kitchen"
},
"id": "43014",
"klikit_id": 43014,
"klikit_category_name": "Menu Satuan",
"klikit_section_name": "Klikit Dimsum",
"name": "Dimsum Cumi",
"quantity": 2,
"price": "13000.00",
"unit_price": "6500.00",
"unit_price_display": "6.500"
}
],
"created_at": "2026-06-24T10:10:14Z",
"currency": "IDR",
"delivery_fee": 730000,
"delivery_fee_display": "7.300",
"delivery_info": {
"address": "Fakultas Bahasa dan Seni Universitas Pendidikan Ganesha, Jl. A. Yani, Kaliuntu, Buleleng, Buleleng, Bali, Indonesia, 81116",
"coordinates": {
"latitude": -8.1121781,
"longitude": 115.085482
},
"email": "[email protected]",
"first_name": "Rezal",
"last_name": "Rezal",
"phone": "+6282155213518"
},
"external_id": "bfb76006-835c-4d61-a789-b3a0afd6d5fc",
"final_price": 1300000,
"final_price_display": "13.000",
"fulfillment_status_id": 9,
"fulfillments": [
{
"delivery_fee": 730000,
"fulfillment_provider_id": 5,
"order_id": 71269954,
"sequence": 1,
"status_id": 9,
"receiver": {
"address": "Fakultas Bahasa dan Seni Universitas Pendidikan Ganesha, Jl. A. Yani, Kaliuntu, Buleleng, Buleleng, Bali, Indonesia, 81116",
"coordinates": {
"latitude": -8.1121781,
"longitude": 115.085482
},
"first_name": "Rezal",
"phone": "+6282155213518"
},
"sender": {
"address": "Jl. Pahlawan, Paket Agung, Kec. Buleleng, Kabupaten Buleleng, Bali 81117",
"coordinates": {
"latitude": -8.124293388269452,
"longitude": 115.0929023057558
},
"country_code": "ID",
"first_name": "TEST - Klikit Healthy Kitchen, Branch: (DEMO) Buleleng",
"phone": "+6285172191644"
}
}
],
"id": 71269954,
"identity": "268053",
"is_manual_order": false,
"is_offline_payment": false,
"item_count": 2,
"item_price": 1300000,
"max_preparation_time": 60,
"order_status_histories": [
{
"id": 253780790,
"order_id": 71269954,
"status": 2,
"processed_at": "2026-06-24T10:10:49Z"
},
{
"id": 253785511,
"order_id": 71269954,
"status": 3,
"processed_at": "2026-06-24T10:25:50Z"
}
],
"payment_channel_id": 49,
"payment_method": 18,
"payment_status": 1,
"preparation_time": 20,
"provider_grand_total": 2030000,
"provider_grand_total_display": "20.300",
"provider_id": 17,
"provider_sub_total": 1300000,
"provider_sub_total_display": "13.000",
"short_id": "1002",
"source": 0,
"status": 3,
"type": 2,
"unique_item_count": 1,
"updated_at": "2026-06-24T10:25:50Z",
"user_email": "[email protected]",
"user_first_name": "Rezal",
"user_id": 160888,
"user_last_name": "Rezal",
"user_phone": "+6282155213518"
}
],
"page": 1,
"size": 2,
"total": 50
}
}{
"request_id": "req_4d1b7e3f-...",
"data": "<unknown>",
"error": {
"code": "request_invalid",
"message": "<string>",
"details": "<unknown>"
}
}{
"request_id": "req_4d1b7e3f-...",
"data": "<unknown>",
"error": {
"code": "auth_invalid_credential",
"message": "<string>",
"details": "<unknown>"
}
}{
"request_id": "req_4d1b7e3f-...",
"data": "<unknown>",
"error": {
"code": "auth_invalid_credential",
"message": "<string>",
"details": "<unknown>"
}
}{
"request_id": "req_4d1b7e3f-...",
"data": "<unknown>",
"error": {
"code": "rate_limit_exceeded",
"message": "<string>",
"details": "<unknown>"
}
}Authorizations
Authorization: Basic base64(partner_key:secret_key).
Credentials are issued by a klikit operator. The plaintext
secret_key is shown once at issuance and cannot be retrieved
later — store it securely. If lost, ask your operator to rotate
the secret to receive a new one. The old secret stops working
immediately on rotation; there is no overlap window.
Query Parameters
Lower bound of created_at (inclusive).
Upper bound of created_at (exclusive). Max window is 90 days.
1-indexed page number. Echoed back in the response body.
Required range:
x >= 1Items per page. Echoed back in the response body.
Required range:
1 <= x <= 100Response
Order list
Canonical response wrapper. Every response — success or error —
carries the request_id so you can quote one id to klikit
support to correlate a request end-to-end.
Example:
"req_4d1b7e3f-..."
Paginated order list payload. page, size, and total echo
the query parameters back so clients can stop iterating once
page * size >= total.
Show child attributes
Show child attributes
Machine-readable error code + human message. The code is stable
across releases — switch on code in your client code rather
than parsing the message text.
Common codes you will encounter as a partner:
| Code | HTTP | Meaning |
|---|---|---|
auth_missing | 401 | Authorization header absent / malformed |
auth_invalid_credential | 401 | partner_key or secret_key did not verify |
auth_revoked | 403 | Credential is revoked |
auth_forbidden | 403 | Credential not authorized for the requested scope |
request_invalid | 400 | Body / query parameters failed validation |
request_missing_idempotency_key | 400 | Write endpoint called without Idempotency-Key |
request_invalid_range | 400 | Date range > 90 days |
resource_not_found | 404 | Order / store / mapping does not exist |
resource_unmapped | 404 | Stock / availability call referenced an unknown SKU |
state_invalid_transition | 409 | Order PATCH not allowed by current state |
state_idempotency_conflict | 409 | Same Idempotency-Key reused with a different body |
rate_limit_exceeded | 429 | Per-credential rate cap hit |
downstream_unavailable | 502 | An internal klikit dependency is unreachable |
Show child attributes
Show child attributes
⌘I