List Orders

Returns a paginated list of orders for the authenticated tenant. Supports combinable filters, field projection, and pagination.

Información

Requires orders:read permission. See Authentication to configure your API key.

Endpoint

List orders with filters and pagination.

Examples

curl -G 'https://api.fenicia.io/orders' \
  -H 'Authorization: Bearer fn_live_xxxxxxxxxxxx' \
  --data-urlencode 'statusGroup=in_progress' \
  --data-urlencode 'limit=50' \
  --data-urlencode 'startDate=2026-04-01T00:00:00Z'

Field projection

Use fields to reduce payload size:

GET /orders?fields=id,externalId,orderStatus,total

Method	Path	Description
`GET`	`/orders/count`	Total count (respects filters).
`GET`	`/orders/count/status-groups`	Count grouped by `statusGroup`.
`GET`	`/orders/count/individual-status`	Count per individual status.

Errors

Code	HTTP	Description
`INVALID_QUERY_PARAM`	400	Invalid or malformed query parameter.
`UNAUTHORIZED`	401	Missing or invalid API key.
`FORBIDDEN`	403	API key lacks `orders:read` permission.
`RATE_LIMIT_EXCEEDED`	429	Exceeded 100 req / 60s.