Orders & FulfillmentOrders & FulfillmentOrders

Returns orders created or updated during the specified time period

Returns orders matching the given filters. Orders are fulfilled by sellers (WFS or seller-fulfilled). Maps to Walmart OMS order queries. ### Current limitations (Phase-2 backlog) The underlying Teflon Order Lookup backend does not yet support every filter declared below. Calls using any of the following will return `400 Bad Request` with `code=FILTER_NOT_SUPPORTED` and a human-readable `message` explaining the specific rejection. Phase 2 (tracked by RCTPAPI-20960) will lift these one-by-one as Teflon adds capability. | Filter | Status today | Reason | |---|---|---| | `createdAfter`, `createdBefore` | Rejected (400) | Teflon Order Lookup does not accept date-range filters at the order level. | | `lastUpdatedAfter` | Rejected (400) | Teflon has no order-level update-date index. | | `orderStatuses` with >1 value | Rejected (400) | Teflon accepts one status per call; pass a single value or omit to match all. | | `fulfillmentTypes` | Rejected (400) | Teflon accepts one shipNodeType per call; multi-type fan-out is Phase 2. | These parameters remain in the contract (rather than being removed) so that SDKs generated today stay forward-compatible with the Phase-2 surface — your code keeps compiling, only the runtime behaviour changes when Phase 2 ships. Until then, omit them or handle the documented 400 gracefully. The `tools/loadgen-orders.sh --contract` smoke sweep exercises the rejection contract on every run.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

createdAfterdatetimeOptional
Filter orders created after this date-time (ISO 8601). **Phase-2 — not yet supported.** Sending this parameter today returns `400 FILTER_NOT_SUPPORTED`; Teflon Order Lookup does not accept date-range filters at the order level. Tracked by RCTPAPI-20960. Retained in the contract so SDKs generated today stay forward-compatible.
createdBeforedatetimeOptional

Filter orders created before this date-time (ISO 8601).

Phase-2 — not yet supported. See createdAfter for the rationale and the tracking ticket.

lastUpdatedAfterdatetimeOptional

Filter orders updated after this date-time (ISO 8601).

Phase-2 — not yet supported. Sending this parameter today returns 400 FILTER_NOT_SUPPORTED; Teflon Order Lookup has no order-level update-date index. Tracked by RCTPAPI-20960.

orderStatuseslist of enumsOptional

Filter by order status.

Phase-2 limitation: Teflon Order Lookup accepts AT MOST ONE status per call. Passing multiple values today returns 400 FILTER_NOT_SUPPORTED; pass a single value or omit to match all. Multi-status fan-out tracked by RCTPAPI-20960.

fulfillmentTypeslist of enumsOptional

Filter by fulfillment type.

Phase-2 — not yet supported. Sending this parameter today returns 400 FILTER_NOT_SUPPORTED; Teflon accepts one shipNodeType per call and multi-type fan-out is Phase 2. Tracked by RCTPAPI-20960.

Allowed values:
pageSizeintegerOptional1-200Defaults to 100
nextTokenstringOptional

Response

Success
payloadobjectOptional

Errors

400
Bad Request Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error