List orders

Any key

Seller API v1 · Updated 7 November 2026

GEThttps://klodivo.com/api/v1/orders

Your parcels: by default the ones to pack and ship.

Authentication

API key in the header Authorization: Bearer kv_live_…. Any key works, also Read only. Create keys under Your store → API.

Query parameters

Name	Type	Description
status	string	to_pack (default), shipped, delivered, completed or all.
page	integer	Page number, from 1.
per_page	integer	Results per page, 1 to 200 (default 100).

Responses

OK. See the example response with the request examples.

Unknown status.

{
  "error": {
    "code": "invalid_status",
    "message": "status is to_pack, shipped, delivered, completed or all."
  }
}

Missing, unknown or revoked key.

{
  "error": {
    "code": "unauthorized",
    "message": "This API key doesn't exist or was revoked."
  }
}

Too many requests. Wait the seconds in Retry-After.

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: up to 120 a minute per key. Try again in 12 s."
  }
}

Still stuck? Contact us; we reply within 2 business days.

PreviousPOST Add a photo NextGET Get an order

curl https://klodivo.com/api/v1/orders?status=to_pack \
  -H "Authorization: Bearer kv_live_…"

$ch = curl_init('https://klodivo.com/api/v1/orders?status=to_pack');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer kv_live_…'],
]);
$answer = json_decode(curl_exec($ch), true);

import requests

r = requests.get(
    "https://klodivo.com/api/v1/orders?status=to_pack",
    headers={"Authorization": "Bearer kv_live_…"},
)
answer = r.json()

const r = await fetch('https://klodivo.com/api/v1/orders?status=to_pack', {
  headers: {
    'Authorization': 'Bearer kv_live_…'
  },
});
const answer = await r.json();

200 Response

{
  "data": [
    {
      "number": "KL-2026-004127",
      "status": "paid",
      "paid_at": "2026-11-02T08:41:10Z",
      "ship_by": "2026-11-04",
      "buyer": {
        "name": "Sam de Vries",
        "country": "NL"
      },
      "ship_to": {
        "full_name": "Sam de Vries",
        "line1": "Oudegracht 112",
        "postal_code": "3511 AX",
        "city": "Utrecht",
        "country": "NL"
      },
      "shipping_service": "PostNL, tracked",
      "buyer_note": null,
      "totals": {
        "items": "24.50",
        "shipping": "4.95",
        "klodivo_fee": "0.61",
        "currency": "EUR",
        "discount": "0.00",
        "discount_code": null
      },
      "carrier": null,
      "tracking_no": null,
      "shipped_at": null,
      "expected_delivery": null,
      "items": [
        {
          "listing_id": 48213,
          "external_ref": "A1-6080",
          "item_no": "6080-1",
          "name": "King's Castle",
          "condition": "Used, good",
          "color": null,
          "quantity": 1,
          "unit_price": "24.50"
        }
      ]
    }
  ],
  "page": 1,
  "per_page": 100,
  "total": 1
}