Reporting API overview

What is Amazon Business’ Reporting API?

Reporting API provides Amazon Business order history data, tracking, and payment details directly to your reporting tools . This API can unlock spend insights by facilitating automated reporting with comprehensive data coverage and support for detailed filtering. With this spend data, procurement teams can develop data-driven spend strategies to optimize value and drive business results.

Benefits of Reporting API

Reporting API provides the following benefits:

Eliminate manual reporting

With a one-time integration, customers can connect Reporting API with their third-party reporting tools to automatically access Amazon Business spend data. This connection can enable seamless, automated spend reporting within your existing systems.

Analyze spend in multiple dimensions

With Reporting API, you can gain access to extensive order-level details, enabling you to manage purchasing data to meet a variety of reporting needs, such as spend by GL code, category, or cost center. You can also analyze shipment and delivery details to drive deeper operational insights.

Enhanced search and filtering capabilities

Reporting API delivers comprehensive filtering options and extended data access. The API supports searching orders within a one-year time range, allows filtering by region and order status, and provides low-latency responses for efficient integrations. With operations tailored to specific use cases such as shipment and order line item reporting, this API allows you to retrieve the precise data you need without unnecessary overhead.

Manage ESG spend

Reporting API provides seller and seller certification fields that you can use to report on consolidated spend with all your diverse suppliers, including spend on certified small, local, or diverse sellers through Amazon Business. Additionally, the API can be integrated with key ESG platforms, enabling centralized visibility into Amazon Business ESG spend.

How Reporting API works

You can retrieve order data by passing requests to specific endpoints based on your reporting needs. In each request, you can pass optional filters, such as order statuses and order IDs, to narrow down the results.

Operations

Reporting API provides five operations:

Operation	Method	Path	Description
`getOrderReports`	GET	/reports/2025-06-09/orderReports	Returns a list of orders within the specified date range. This operation can be used for spend analysis by reviewing a list of orders within the last year, with each order's associated PO numbers, order totals, and order status.
`getOrderLineItemReports`	GET	/reports/2025-06-09/orderLineItemReports	Retrieves detailed line item data for orders meeting the requested criteria. This operation can be used to perform granular spend analysis reporting such as evaluating ASINs under an order number, performing compliance and enivironmental tracking using seller information.
`getOrderReportsByPurchaseOrderNumber`	GET	/reports/2025-06-09/purchaseOrders/{purchaseOrderNumber}/orderReports	Fetches orders associated with a purchase order number. This operation allows you to retrieve details for specific orders.
`getShipmentReports`	GET	/reports/2025-06-09/shipmentReports	Retrieves shipment data matching the requested criteria. This operation can be used to build high-level shipping reports to track shipments based on order data, analyze orders based on shipment status, and validate shipping addresses.
`getShipmentLineItemReports`	GET	/reports/2025-06-09/shipmentLineItemReports	Provides detailed shipment line item data including receiving information.

Each successful Reporting API request returns data about the orders matching the requested criteria.

📘
Reporting API fetches orders from all legal entities under the Amazon Business account.

Getting started

Complete these steps to access Reporting API:

Complete the API onboarding process to register as a developer, create an app client, and retrieve API access and refresh tokens. For more information, see Onboarding overview.
Gain access to the Amazon Business Analytics role. For more information, see Amazon Business API roles.

👍
These steps are only required if you have not yet already integrated with Reporting API v2021-01-08. If you have an existing integration with this version, you can begin calling v2025-06-09 without any additional action required.

Once you’ve completed these steps, follow these guides to integrate with the API: