Skip to main content
GET
/
v1
/
partner
/
orders
List orders
curl --request GET \
  --url https://api.dev.shadowchef.co/v1/partner/orders \
  --header 'Authorization: Basic <encoded-value>'
{
  "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
  }
}

Authorizations

​
Authorization
string
header
required

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

​
from
string<date-time>

Lower bound of created_at (inclusive).

​
to
string<date-time>

Upper bound of created_at (exclusive). Max window is 90 days.

​
status
string
​
provider_id
integer
​
branch_id
integer
​
page
integer
default:1

1-indexed page number. Echoed back in the response body.

Required range: x >= 1
​
size
integer
default:20

Items per page. Echoed back in the response body.

Required range: 1 <= x <= 100

Response

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.

​
request_id
string
required
Example:

"req_4d1b7e3f-..."

​
data
object

Paginated order list payload. page, size, and total echo the query parameters back so clients can stop iterating once page * size >= total.

​
error
object

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:

CodeHTTPMeaning
auth_missing401Authorization header absent / malformed
auth_invalid_credential401partner_key or secret_key did not verify
auth_revoked403Credential is revoked
auth_forbidden403Credential not authorized for the requested scope
request_invalid400Body / query parameters failed validation
request_missing_idempotency_key400Write endpoint called without Idempotency-Key
request_invalid_range400Date range > 90 days
resource_not_found404Order / store / mapping does not exist
resource_unmapped404Stock / availability call referenced an unknown SKU
state_invalid_transition409Order PATCH not allowed by current state
state_idempotency_conflict409Same Idempotency-Key reused with a different body
rate_limit_exceeded429Per-credential rate cap hit
downstream_unavailable502An internal klikit dependency is unreachable