cancelOrder

put

https://sellingpartnerapi-na.amazon.com/orders/2026-01-01/orders/{orderId}/cancellation

Cancels the order you specify. Partial cancellations are not supported.

Usage Plan:

Rate (requests per second)	Burst
1	5

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

Path Params

orderId

string

required

An Amazon-defined order identifier.

Body Params

The request body of the cancelOrder operation, including the reason for the cancellation.

The request body of the cancelOrder operation, which includes the reason for the cancellation.

cancelReasonCode

string

enum

required

Predefined codes that specify the reason for why an order is canceled, used for tracking and reporting purposes.

Show Details

NO_INVENTORY	Cancellation due to insufficient stock.
BUYER_CANCELLED	Cancellation requested by the customer.
SHIPPING_ADDRESS_UNDELIVERABLE	Cancellation due to invalid or inaccessible delivery address.
CUSTOMER_EXCHANGE	Cancellation for product exchange purposes.
PRICING_ERROR	Cancellation due to incorrect product pricing.

Allowed:

Responses

Language

Loading…

Response

Choose an example:

application/json

202Success.

400Request has missing or invalid parameters and cannot be parsed.

401The request's Authorization header is not formatted correctly or does not contain a valid token.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.