> ## Documentation Index
> Fetch the complete documentation index at: https://docs.khaime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List business orders

> The business's orders, newest first.

The business's orders, newest first. Orders contain customer information, so show them only behind a login.

Call this from your server with a `pk_` key. See [Store data overview](https://docs.khaime.com/api-reference/store-data/overview.md) for keys, errors and how to read empty values.

## Parameters

| Name | Type | Required | Description |
| - | - | - | - |
| `payment_status` | string | No | `unpaid`, `attempted`, `paid`, `failed` or `refunded`. |
| `delivery_status` | string | No | `pending`, `processing`, `shipped`, `out_for_delivery`, `delivered`, `cancelled` or `returned`. |
| `since` | string | No | Orders placed on or after this `YYYY-MM-DD`. |
| `until` | string | No | Orders placed on or before this `YYYY-MM-DD`. |
| `limit` | integer | No | How many rows, 1 to 50. Default 20. |

## Request

```bash theme={null}
curl -H "X-API-Key: $KHAIME_API_KEY" \
  "https://api.khaime.com/api/v1/analytics/orders?payment_status=paid&limit=20"
```

## Response

```json theme={null}
{
  "message": "Orders retrieved",
  "success": true,
  "status": true,
  "data": {
    "environment": "live",
    "total": 38,
    "items": [
      {
        "id": 9012,
        "order_number": "KH-9012",
        "amount": {
          "minor": 8200,
          "currency": "USD"
        },
        "payment_status": "paid",
        "delivery_status": "shipped",
        "customer_id": 771,
        "created_at": "2026-10-31T14:03:11.000Z"
      }
    ]
  }
}
```

## Read it correctly

* `amount.minor` is in hundredths of `amount.currency`. `amount` is `null` when no amount was recorded. That does not mean the order was free.
* `total` counts every match. To read past the limit, make `until` earlier.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.