Sales API

You use the Sales API to retrieve information about sales performance. You can get aggregated order metrics for a given period of time, broken down by granularity, and buyer type. Refer to the Sales API Reference for details about Sales API operations and associated data types and schemas.

Current version	Legacy versions	Availability	Sandbox
v1 (Reference \| Model)	None	Sellers only	Static

Release notes

May 28, 2025

To learn more about the terms that are used on this page, refer to Terminology.

Use cases

The follow use case example is available for the Sales API:

Receive sales performance information: Call the getOrderMetrics operation to receive aggregated order metrics for a given interval.

Roles

getOrderMetrics

Attribute	Value
Regions	NA, EU, FE except where noted
Required roles (need at least one)	Amazon Fulfillment (FE only) Buyer Communication (FE only) Buyer Solicitation (FE only) Finance and Accounting (FE only) Inventory and Order Tracking Pricing (FE only) Product Listing Professional Services (Restricted) (FE only) Selling Partner Insights (FE only) Direct to Consumer Shipping (Restricted) (FE only) Tax Invoicing (Restricted) (FE only) Tax Remittance (Restricted) (FE only)