HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
API Reference
Developer HubAPI StatusSupport

listAllFulfillmentOrders

Returns a list of fulfillment orders fulfilled after (or at) a specified date-time, or indicated by the next token parameter.

Usage Plan:

Rate (requests per second)Burst
230

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API

Query Params
date-time

A date used to select fulfillment orders that were last updated after (or at) a specified time. An update is defined as any change in fulfillment order status, including the creation of a new fulfillment order.

string

A string token returned in the response to your previous request.

Responses

Response body
object
payload
object

The request for the listAllFulfillmentOrders operation.

string

When present and not empty, pass this string token in the next request to return the next response page.

fulfillmentOrders
array of objects

An array of fulfillment order information.

fulfillmentOrders
object
string
required

The fulfillment order identifier submitted with the createFulfillmentOrder operation.

string
required

The identifier for the marketplace the fulfillment order is placed against.

string
required

A fulfillment order identifier submitted with the createFulfillmentOrder operation. Displays as the order identifier in recipient-facing materials such as the packing slip.

date-time
required

Date timestamp

string
required

A text block submitted with the createFulfillmentOrder operation. Displays in recipient-facing materials such as the packing slip.

string
required

The shipping method used for the fulfillment order. When this value is ScheduledDelivery, choose Ship for the fulfillmentAction. Hold is not a valid fulfillmentAction value when the shippingSpeedCategory value is ScheduledDelivery.
Note: Shipping method service level agreements vary by marketplace. Sellers should refer to the Seller Central website in their marketplace for shipping method service level agreements and fulfillment fees.

Standard Expedited Priority ScheduledDelivery

Show Details
StandardStandard shipping method.
ExpeditedExpedited shipping method.
PriorityPriority shipping method.
ScheduledDeliveryScheduled Delivery shipping method. This is only available in the JP marketplace.
deliveryWindow
object

The time range within which a Scheduled Delivery fulfillment order should be delivered. This is only available in the JP marketplace.

destinationAddress
object
required

A physical address.

string

Specifies whether the fulfillment order should ship now or have an order hold put on it.

Ship Hold

Show Details
ShipThe fulfillment order ships now.
HoldAn order hold is put on the fulfillment order.
string

The FulfillmentPolicy value specified when you submitted the createFulfillmentOrder operation.

FillOrKill FillAll FillAllAvailable

Show Details
FillOrKillIf an item in a fulfillment order is determined to be unfulfillable before any shipment in the order has acquired the status of Pending (the process of picking units from inventory has begun), then the entire order is considered unfulfillable. However, if an item in a fulfillment order is determined to be unfulfillable after a shipment in the order has acquired the status of Pending, Amazon cancels as much of the fulfillment order as possible. Refer to the `FulfillmentShipment` object for shipment status definitions.
FillAllAll fulfillable items in the fulfillment order are shipped. The fulfillment order remains in a processing state until all items are either shipped by Amazon or cancelled by the seller.
FillAllAvailableAll fulfillable items in the fulfillment order are shipped. All unfulfillable items in the order are cancelled.
codSettings
object

The COD (Cash On Delivery) charges that you associate with a COD fulfillment order.

date-time
required

Date timestamp

string
required

The current status of the fulfillment order.

New Received Planning Processing Cancelled Complete CompletePartialled Unfulfillable Invalid

Show Details
NewThe fulfillment order was received but not yet validated.
ReceivedThe fulfillment order was received and validated. Validation includes determining that the destination address is valid and that Amazon's records indicate that the seller has enough sellable (undamaged) inventory to fulfill the order. The seller can cancel a fulfillment order that has a status of Received.
PlanningThe fulfillment order has been sent to Amazon's fulfillment network to begin shipment planning, but no unit in any shipment has been picked from inventory yet. The seller can cancel a fulfillment order that has a status of Planning.
ProcessingThe process of picking units from inventory has begun on at least one shipment in the fulfillment order. The seller cannot cancel a fulfillment order that has a status of Processing.
CancelledThe fulfillment order has been cancelled by the seller.
CompleteAll item quantities in the fulfillment order have been fulfilled.
CompletePartialledSome item quantities in the fulfillment order were fulfilled; the rest were either cancelled or unfulfillable.
UnfulfillableNo item quantities in the fulfillment order could be fulfilled because the Amazon fulfillment center workers found no inventory for those items or found no inventory that was in sellable (undamaged) condition.
InvalidThe fulfillment order was received but could not be validated. The reasons for this include an invalid destination address or Amazon's records indicating that the seller does not have enough sellable inventory to fulfill the order. When this happens, the fulfillment order is invalid and no items in the order will ship.
date-time
required

Date timestamp

notificationEmails
array of strings

A list of email addresses that the seller provides that are used by Amazon to send ship-complete notifications to recipients on behalf of the seller.

notificationEmails
featureConstraints
array of objects

A list of features and their fulfillment policies to apply to the order.

featureConstraints
object
string

The name of the feature.

string

Specifies the policy to use when fulfilling an order.

Required NotRequired

Show Details
RequiredIf the offer can't be shipped with the selected feature, reject the order.
NotRequiredThe feature is not required for shipping.
errors
array of objects

A list of error responses returned when a request is unsuccessful.

errors
object
string
required

An error code that identifies the type of error that occurred.

string
required

A message that describes the error condition.

string

Additional details that can help the caller understand or fix the issue.

Headers
object
string

Your rate limit (requests per second) for this operation.

string

Unique request reference identifier.

Language