--- updatedAt: 2026-10-30T17:16:02.000Z agentTools: siteIndex: https://developer-docs.amazon/llms.txt projectIndex: https://developer-docs.amazon/sp-api/llms.txt --- # Merchant Fulfillment API Learn how to use the Merchant Fulfillment API. You use the Merchant Fulfillment API to build <>s for sellers to use Amazon Buy Shipping services to purchase shipping for non-Prime and Prime orders. > 📘 Note > > For new integrations, use the [Shipping API v2](https://developer-docs.shipping.amazon.com/apis/docs/shipping-api-v2-reference) instead. | Current version | Legacy versions | Availability | Sandbox | | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------- | :----------- | :------ | | v0 ([Reference](https://developer-docs.amazon.com/sp-api/reference/merchant-fulfillment-v0 "Access the complete API reference documentation for the Merchant Fulfillment API.") \| [Model](https://github.com/amzn/selling-partner-api-models/blob/main/models/merchant-fulfillment-api-model/merchantFulfillmentV0.json "Access the JSON schema model for the Merchant Fulfillment API.")) | None | Sellers only | Static |
Release notes \- [October 1, 2025](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#october-1-2025) * [November 6, 2024](https://developer-docs.amazon.com/sp-api/page/release-notes#november-6-2024) * [July 8, 2024](https://developer-docs.amazon.com/sp-api/page/release-notes#july-8-2024) * [June 28, 2024](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#june-28-2024) * [March 20, 2024](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#march-20-2024) * [December 13, 2023](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#december-13-2023) * [November 8, 2023](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#november-8-2023) * [October 11, 2023](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#october-11-2023) * [September 20, 2023](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#september-20-2023) * [February 22, 2023](https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes#february-22-2023)
> 📘 EU customs requirement for cross-border shipments > > Starting **November 1, 2026**, EU customs requires product identifiers for business-to-consumer (B2C) goods shipped into the EU from outside the EU. If you ship FBM orders from outside the EU to EU customers, refer to [Include additional seller input data](https://developer-docs.amazon.com/sp-api/docs/include-seller-input-data#example-eu-customs-product-identifiers-for-cross-border-shipments) to prepare your integration. To learn more about the terms that are used in this guide, refer to [Terminology](https://developer-docs.amazon.com/sp-api/docs/terminology). ## Use cases The following use case examples are available for the Merchant Fulfillment API v0: * [Fulfill seller-fulfilled Prime and non-Prime orders](https://developer-docs.amazon.com/sp-api/docs/fulfill-orders): Identify Prime and non-Prime orders and create shipments. * [Cancel a shipment](https://developer-docs.amazon.com/sp-api/docs/cancel-a-shipment): Use the `cancelShipment` operation. * [Manipulate shipping labels](https://developer-docs.amazon.com/sp-api/docs/manipulate-shipping-labels): Extract document data from a compressed file and reprint a shipping label. * [Include additional seller input data](https://developer-docs.amazon.com/sp-api/docs/include-seller-input-data): Provide additional seller inputs for shipment services that require them. * [Subscribe to MFN notifications](https://developer-docs.amazon.com/sp-api/docs/subscribe-to-mfn-notifications): Use the Selling Partner API for Notifications to subscribe to notifications that are relevant to a selling partner's business. ## FBM Ship+ program availability The following table shows FBM Ship+ program availability by Amazon store. To learn more about the program, refer to [Tutorial: Integrate FBM Ship+ with ERPs and Multi-Channel Integrators](https://developer-docs.amazon.com/amazon-shipping/docs/tutorial-integrate-fbm-ship-with-erps-and-multi-channel-integrators). | Amazon store | Cross-border (China origin) | Domestic | | :----------- | :-------------------------: | :-----------------------: | | US | CN2US | US DOM (Starting 06/2026) | | UK | CN2UK | UK DOM | | DE | CN2DE | DE DOM | | ES | CN2ES | ES DOM (Starting Q3 2026) | | FR | CN2FR | FR DOM (Starting Q4 2026) | | IT | CN2IT | IT DOM (Starting Q4 2026) | | JP | CN2JP | - | | AU | CN2AU | - | ## Roles for the Merchant Fulfillment API v0
cancelShipment | Attribute | Value | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Regions | NA, EU, FE | | Required roles (need at least one) | [Direct to Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) |
createShipment | Attribute | Value | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Regions | NA, EU, FE | | Required roles (need at least one) | [Direct to Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) |
getAdditionalSellerInputs | Attribute | Value | | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Regions |  NA, EU, FE except where noted | | Required roles (need at least one) |  [Buyer Communication](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#buyer-communication) (NA, FE only)
 [Direct to Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) |
getEligibleShipmentServices | Attribute | Value | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Regions | NA, EU, FE | | Required roles (need at least one) | [Direct to Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) |
getShipment | Attribute | Value | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Regions | NA, EU, FE | | Required roles (need at least one) | [Direct to Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) |
## Error codes The following table describes the Merchant Fulfillment error codes. | Error code | HTTP status code | Description | | :------------------------------------- | :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `InsufficientFunds` | 400 | The requested shipping label purchase was rejected because of insufficient funds in the seller's account. | | `InvalidRequest` | 400 | Request has missing or invalid parameters and cannot be parsed. This includes a missing required EU customs product identifier for a shipment from outside the EU to an EU address; refer to [Include additional seller input data](https://developer-docs.amazon.com/sp-api/docs/include-seller-input-data#handle-missing-product-identifiers). | | `InvalidShipFromAddress` | 400 | The specified `ShipFromAddress` value is invalid. Specify a valid address. | | `InvalidShippingServiceOfferId` | 400 | The specified `ShippingServiceOfferId` value is invalid. Specify a `ShippingServiceOfferId` value returned by a previous call to the [`getEligibleShipmentServices`](https://developer-docs.amazon.com/sp-api/reference/geteligibleshipmentservices) operation. | | `LabelCancelWindowExpired` | 400 | The cancellation window for requesting a label refund has expired. Cancellation policies vary by carrier. For more information about carrier cancellation policies, refer to the Seller Central Help Hub for your [Amazon store](https://developer-docs.amazon.com/sp-api/docs/seller-central-urls). | | `LabelFormatNotSupported` | 400 | The requested `LabelFormat` does not match the available formats. | | `ShipmentAlreadyExists` | 400 | One or more items specified in a call to the [`createShipment`](https://developer-docs.amazon.com/sp-api/reference/createshipment) operation have already shipped. Specify only unshipped items. A `ShipmentId` is returned in the `Message` element of the error message for each specified item that has already shipped. | | `ShipmentRequestDetailsTooRestrictive` | 400 | The specified `ShipmentRequestDetails` and `ShippingServiceId` values are so restrictive that no shipping service offer is available that can fulfill the request. Try calling the [`createShipment`](https://developer-docs.amazon.com/sp-api/reference/createshipment) operation again with less restrictive values, or first call the [`getEligibleShipmentServices`](https://developer-docs.amazon.com/sp-api/reference/geteligibleshipmentservices) operation to check if there are any shipping service offers available that match the `ShipmentRequestDetails` and `ShippingServiceId` values that you specify. | | `ShippingServiceOfferNotAvailable` | 400 | The specified `ShippingServiceOfferId` value is no longer valid. This could be because the shipping rate changed since you received the `ShippingServiceOfferId` value with a previous call to the [`getEligibleShipmentServices`](https://developer-docs.amazon.com/sp-api/reference/geteligibleshipmentservices) operation. Call the [`getEligibleShipmentServices`](https://developer-docs.amazon.com/sp-api/reference/geteligibleshipmentservices) operation again to get a new `ShippingServiceOfferId` value. | | `InvalidState` | 404 | The request cannot be applied to the shipment in its current state. For example, a shipment in the `RefundApplied` state cannot be canceled. | | `ItemsNotInOrder` | 404 | Items specified in a call to the [`createShipment`](https://developer-docs.amazon.com/sp-api/reference/createshipment) operation are not part of the order specified in the same call. | | `RegionNotSupported` | 404 | The specified order is from an Amazon store where the Merchant Fulfillment service is not supported. | | `ResourceNotFound` | 404 | The specified resource (such as `ShipmentId` or `AmazonOrderId`) does not exist. | | `ShippingServiceNotAvailable` | 404 | The specified shipping service does not exist or is not available for the specified parameters (for example, Weight). |