Skip to main content
GET
/
v1
/
partner
/
orders
/
fulfillment-statuses
Enum of valid fulfillment statuses
curl --request GET \
  --url https://api.dev.shadowchef.co/v1/partner/orders/fulfillment-statuses \
  --header 'Authorization: Basic <encoded-value>'
{
  "request_id": "1b4a155b1823442010bbd14a1a534633",
  "data": [
    {
      "id": 1,
      "status": "DISPATCHING",
      "translation": {
        "en": "DISPATCHING",
        "id": "Menugaskan",
        "vi": "Gửi đi"
      }
    },
    {
      "id": 2,
      "status": "ALLOCATING",
      "translation": {
        "en": "ALLOCATING",
        "id": "Mengalokasikan",
        "vi": "Phân bổ"
      }
    },
    {
      "id": 3,
      "status": "PENDING_PICKUP",
      "translation": {
        "en": "PENDING PICKUP",
        "id": "Penjemputan Tertunda",
        "vi": "Đang chờ nhận"
      }
    },
    {
      "id": 4,
      "status": "PICKING_UP",
      "translation": {
        "en": "PICKING UP",
        "id": "Mengambil",
        "vi": "Nhặt lên"
      }
    },
    {
      "id": 5,
      "status": "IN_DELIVERY",
      "translation": {
        "en": "IN DELIVERY",
        "id": "Dalam Pengiriman",
        "vi": "Trong quá trình giao hàng"
      }
    },
    {
      "id": 6,
      "status": "COMPLETED",
      "translation": {
        "en": "COMPLETED",
        "id": "Selesai",
        "vi": "Hoàn thành"
      }
    },
    {
      "id": 7,
      "status": "RETURNED",
      "translation": {
        "en": "RETURNED",
        "id": "Kembali",
        "vi": "Trả lại"
      }
    },
    {
      "id": 8,
      "status": "FAILED",
      "translation": {
        "en": "FAILED",
        "id": "Gagal",
        "vi": "Thất bại"
      }
    },
    {
      "id": 9,
      "status": "CANCELED",
      "translation": {
        "en": "CANCELED",
        "id": "Dibatalkan",
        "vi": "Đã hủy"
      }
    },
    {
      "id": 10,
      "status": "IN_RETURN",
      "translation": {
        "en": "IN RETURN",
        "id": "Dalam Pengembalian",
        "vi": "Đổi lại"
      }
    },
    {
      "id": 11,
      "status": "DISPATCH_FAILED",
      "translation": {
        "en": "DISPATCH FAILED",
        "id": "Pengiriman Gagal",
        "vi": "Không thể gửi đi"
      }
    },
    {
      "id": 12,
      "status": "SWITCHED_TO_MANUAL",
      "translation": {
        "en": "SWITCHED TO MANUAL",
        "id": "Ubah ke manual",
        "vi": "Đã chuyển sang thủ công"
      }
    },
    {
      "id": 13,
      "status": "DELETED",
      "translation": {
        "en": "DELETED",
        "id": "Dihapus",
        "vi": "Đã xóa"
      }
    }
  ]
}

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.

Response

200 - application/json

Fulfillment-status enum

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[]

Endpoint-specific payload on success.

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