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 this spend data, procurement teams can develop data-driven spend strategies to optimize value and drive business results.

👍
Test this API in the Amazon Business API Explorer!

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.

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 a request to Reporting API.

Operations

Reporting API provides two operations:

Operation	Method	Path	Description
`getOrdersByOrderDate`	GET	/reports/2021-01-08/orders	Returns a paginated list of orders with order dates that fall within the date range that you specify. You can optionally retrieve line items, charges, and shipments for these orders.
`getOrdersByOrderId`	GET	/reports/2021-01-08/orders/{orderId}	Fetches details for a specific order based on the order identifier. You can optionally retrieve line items, charges, and shipments for this order.

Each successful Reporting API request returns data about the orders matching the requested criteria (date range or ID).

📘
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.

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