GET /v1/catalogue/orders

The account’s orders, newest first — from carts, agents, the panel and the API.

The account’s orders, newest first, wherever they came from.

Needs the catalogue.orders:read scope.

Query parameters

Field	Type	Required	Notes
status	string	No	new, confirmed, declined, fulfilled or cancelled.
contact	string	No	Only this contact’s — a contact’s id.
limit	integer	No	1 to 100; 50 by default.
starting_after	string	No	The last id of the previous page — next from it.

Request

cURL

curl "https://api.fireflo.au/v1/catalogue/orders?status=new&limit=10" \
  -H "Authorization: Bearer $OMNI_API_KEY"

Response

200 OK — has_more says whether there is another page, and next is the starting_after for it. status is new, confirmed, declined, fulfilled or cancelled. source is where it came from: cart (a WhatsApp cart), agent (an AI agent’s draft, approved by a person), person (made by hand in the panel) or api. channel is the channel it came in on, where replies about it go. Each line keeps its own copy of the name and price, so a later change to the product doesn’t rewrite it; product is the product’s id, or null for a SKU the catalogue doesn’t have. Money is in minor units.

{
  "data": [
    {
      "id": "9d4e2b7a-1c3f-4a8e-b6d5-0f2e7c9a1b34",
      "number": 1043,
      "status": "new",
      "source": "api",
      "channel": "whatsapp",
      "contact": {
        "id": "5b2f9e1c-8a3d-4c7e-9f61-2d4b7a0e3c85",
        "name": "Asha Menon",
        "phone": "[phone]"
      },
      "items": [
        {
          "product": "3f8a2c1e-7b4d-4e6a-9c2f-1a5b8d7e6f40",
          "sku": "KUR-COT-IND-M",
          "name": "Cotton kurta — indigo, M",
          "quantity": 2,
          "unit_price_minor": 199900
        },
        {
          "product": "a71c5e93-2d8b-4f16-8e0a-6b9d3c2f1e57",
          "sku": "DUP-PHUL-RED",
          "name": "Phulkari dupatta — red",
          "quantity": 1,
          "unit_price_minor": 179900
        }
      ],
      "total_minor": 579700,
      "currency": "INR",
      "note": "Gift wrap, please.",
      "created_at": "2026-10-06T11:08:37+05:30",
      "updated_at": "2026-10-06T11:08:37+05:30"
    }
  ],
  "has_more": false,
  "next": null
}

Errors

Every refusal is {"error": {"code", "message", "field"}}; field is there when one input is at fault.

Status	Error code	When
400	invalid_request	status or limit isn’t one, contact isn’t one of the account’s contacts, or starting_after isn’t an id from this list (field names it).
404	module_off	The account doesn’t have Catalogue on.
403	scope_missing	The key doesn’t have the catalogue.orders:read scope.

Any request can also be refused for its key, its account or its rate (key_required, invalid_key, account_suspended, plan_excludes_api, address_not_allowed, rate_limited); see the overview.