Skip to main content
GET
/
v1
/
partner
/
orders
/
{id}
Get one order
curl --request GET \
  --url https://api.dev.shadowchef.co/v1/partner/orders/{id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "request_id": "abde04ce73347f67a3ca97e907f80ca6",
  "data": {
    "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,
    "can_accept": false,
    "can_cancel": true,
    "can_ready": false,
    "can_void": true,
    "cart": [
      {
        "brand": {
          "id": 5297,
          "logo": "/images/1a0cd999ecf8d62acb4f558ff8fb747ae5fe6b61.jpeg",
          "title": "(DEMO) Cimol Bojot AA"
        },
        "description": "Cimol Beef Porsi Besar Isi 14 Pcs",
        "groups": [],
        "item_id": 289379,
        "klikit_category_id": 39118,
        "klikit_category_name": "Cimol Beef",
        "klikit_id": 289379,
        "klikit_name": "Cimol Beef Porsi Besar",
        "klikit_section_id": 6825,
        "klikit_section_name": "Cimol Bojot AA Master Menu",
        "klikit_sku_id": "CBA001",
        "price": 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"
        },
        "id": "289379",
        "klikit_id": 289379,
        "klikit_name": "Cimol Beef Porsi Besar",
        "klikit_name_translation": {
          "en": "Cimol Beef Porsi Besar"
        },
        "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",
    "external_id": "1782302607204811041",
    "fee_paid_by_customer": true,
    "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_queue": 4,
    "order_status_histories": [
      {
        "id": 253820147,
        "order_id": 71280866,
        "status": 1,
        "processed_at": "2026-06-24T12:03:27Z"
      },
      {
        "id": 253820195,
        "order_id": 71280866,
        "status": 2,
        "processed_at": "2026-06-24T12:03:35Z"
      },
      {
        "id": 253820300,
        "order_id": 71280866,
        "status": 4,
        "processed_at": "2026-06-24T12:03:49Z"
      },
      {
        "id": 253820409,
        "order_id": 71280866,
        "status": 5,
        "processed_at": "2026-06-24T12:04:02Z"
      }
    ],
    "owned_by": 11745,
    "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",
    "shift_session_id": 12933,
    "short_id": "1004",
    "source": 9,
    "status": 5,
    "status_updated_by": 11745,
    "type": 3,
    "unique_item_count": 1,
    "updated_at": "2026-06-24T12:04:02Z",
    "user_full_name": "Tiwi Support Testing Account",
    "user_role": "branch_manager",
    "vat": 0
  }
}

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.

Path Parameters

id
string
required

Response

Order payload

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

A single order record. The same shape is returned by listOrders (inside data.orders[]), getOrder (as data), and on the webhook payloads (inside orders[]).

Only the most commonly consumed fields are documented below; the wire response carries ~100+ fields per order including finance breakdowns (provider_*, merchant_*, *_display), BIR (Philippines) fields, fulfillment timeline, and operator metadata. Partners should treat unknown fields as ignorable.

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