Search Orders

Run full-text searches over orders. The query term is matched simultaneously against customer name and email, order ID (internal and external), and line-item SKUs.

Información

Requires orders:read permission. For paginated lists with structured filters, use List orders.

Endpoint

Full-text search with optional filters.

Examples

curl -G 'https://api.fenicia.io/orders/search' \
  -H 'Authorization: Bearer fn_live_xxxxxxxxxxxx' \
  --data-urlencode 'q=jane@example.com' \
  --data-urlencode 'status=accepted'

Use cases

Customer support: quickly look up an order by the customer's email.
Reconciliation: locate orders by SKU when investigating stock reports.
Auditing: retrieve an order by its external marketplace ID.

Errors

Code	HTTP	Description
`MISSING_QUERY`	400	Missing required `q` parameter.
`UNAUTHORIZED`	401	Missing or invalid API key.
`FORBIDDEN`	403	Insufficient permission (`orders:read`).
`RATE_LIMIT_EXCEEDED`	429	Exceeded 100 req / 60s.

List orders
Order CRUD
API overview