List Unified MCF Fulfillment Orders
GET/api/amazon/unified/fulfillment-orders
Returns a paginated list of MCF (Multi-Channel Fulfillment) orders aggregated across all Amazon integration instances the user has access to. Supports Spatie QueryBuilder filters and sorts.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Each item carries a derived mapping_status (unmapped, mapped_shipped, mapped_pending, unmappable, historical, archived), linked_via (fulfillment | fulfillment_order | null), and sales_order resolved through whichever link is set — an MCF order linked to a fulfillment order but not yet shipped by Amazon reports mapped_pending with its sales order.
The response also carries meta.mapping_counts (rows per bucket for the current filters, ignoring the mapping_status and lifecycle filters) and meta.cutover (hidden_historical_count, has_cutover). Orders dated before the account's MCF cutover date (integration setting mcf_cutover_date, falling back to start_date) are classified historical and excluded from the unmapped count.
Allowed sorts: id, sellerFulfillmentOrderId, displayableOrderId, displayableOrderDate, receivedDate, statusUpdatedDate, fulfillmentOrderStatus, fulfillmentAction, shippingSpeedCategory, created_at, updated_at, archived_at (snake_case aliases accepted). Default sort: -displayableOrderDate. Pagination: page, per_page (default 10).
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.