Orders API

The Fenicia Orders API lets merchants manage the full order lifecycle: from manual creation to fulfillment and shipping, including marketplace integrations.

What can you do?

• List and search orders with advanced filters (status, channel, dates, customer).
• Create manual orders from the dashboard or POS.
• Retrieve full order detail with HATEOAS links to related actions.
• Update order info, payment status, and tags.
• Aggregate count metrics by status and status group.

Core concepts

Order lifecycle

Each order transitions through a canonical set of states:

pending → accepted → preparing → shipped → delivered
                  ↘ cancelled

Status groups

Statuses are grouped for dashboard visualization:

Multi-tenant

All endpoints are automatically isolated by tenantId (inferred from your API key). You will never see another merchant's data.

Response envelope

All API responses follow a consistent format:

List success:

{
  "orders": [ /* ... */ ],
  "pagination": {
    "page": 0,
    "limit": 20,
    "total": 142,
    "hasMore": true
  }
}

Single resource success:

{
  "order": { /* ... */ },
  "_links": {
    "self": { "href": "/orders/ord_123" },
    "cancel": { "href": "/orders/ord_123/cancel" }
  }
}

Error:

{
  "error": {
    "code": "ORDER_NOT_FOUND",
    "message": "Order not found",
    "details": { "orderId": "ord_123" }
  }
}

Rate limits

Quick start

curl -X GET 'https://api.fenicia.io/orders?limit=10' \
  -H 'Authorization: Bearer fn_live_xxxxxxxxxxxx'

Related articles

• Authentication — Authenticate requests with API keys.
• List orders — Pagination, filters, and field projection.
• Order CRUD — Create, retrieve, and update orders.
• Search orders — Full-text search by customer, SKU, or ID.