List orders

GET/api/v1/ordersRead, no scope needed

Orders taken in conversation, oldest first, for a store connector to create in the store.

Until the store acknowledges an order (POST /api/v1/orders/{id}/status with its own order id), Floee holds those units back as reserved.

Request

curlshell

curl -X GET "https://icebot.icebergaisolutions.com/api/v1/orders?limit=50" \
  -H "Authorization: Bearer $ICEBOT_API_KEY"

Parameters

Name	In	Type	Description
`since`	query	ISO 8601 timestamp	Only orders created after this instant. Page forward by passing the last created_at you saw.
`unacknowledged`	query	1	Only orders the store has not yet acknowledged (no external_id).
`limit`	query	integer	Page size, 1 to 100. Default 50.

Responses

`200`

One page of orders. Amounts are ringgit, not sen.

200 responsejson

{
  "data": [
    {
      "id": "b2d4e6f8-1a3c-4e5f-8a9b-0c1d2e3f4a5b",
      "order_number": "IB-1042",
      "status": "pending_payment",
      "channel": "voice",
      "currency": "MYR",
      "subtotal": 25.8,
      "total": 25.8,
      "created_at": "2026-09-27T03:20:11.000Z",
      "external_id": null,
      "external_status": null,
      "customer": {
        "name": "Aisyah",
        "phone": "+60123456789"
      },
      "lines": [
        {
          "name": "Nasi lemak ayam goreng",
          "quantity": 2,
          "unit_price": 12.9,
          "special_instructions": "Sambal on the side",
          "product_id": "0a7d3e21-5c44-4b8e-9f10-6e2d8c9b1a37",
          "variant_id": null,
          "product_external_id": "101",
          "variant_external_id": null,
          "sku": "NL-AYAM"
        }
      ]
    }
  ],
  "hasMore": false
}

Errors

Every endpoint can also return 401 (missing, unknown or revoked key), 403 (origin not allowed) and 429 (rate limited). See Errors.

Status	error	When
`400`	`since must be an ISO timestamp`	since does not parse as a date.

Source of truth: /api/v1/orders in apps/dashboard/app/api/v1/orders/route.ts.