getInvoices

get

https://api.business.amazon.com/ab-invoice/2026-02-01/invoices

Returns a paginated list of invoices within the specified date range. This endpoint searches for invoices from all legal entities associated with the caller based on specified search criteria.

Usage Plan:

Rate (requests per second)	Burst
0.5	10

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. For questions about your usage plan, reach out to your Amazon Business technical contact.

Query Params

invoiceIssueStartDate

date-time

required

The start of the invoice issue date range to search for invoices, in ISO 8601 format. Must not be more than 366 days before invoiceIssueEndDate.

invoiceIssueEndDate

date-time

required

The end of the invoice issue date range to search for invoices, in ISO 8601 format. Must not be in the future and must not be more than 366 days after invoiceIssueStartDate.

region

string

enum

The region to filter invoices by. If provided, the API returns invoices in the specified region. Any invoices not in the specified region are not returned. If not provided, the API returns invoices from all marketplaces in the region of the API request.

Allowed:

paymentMethodTypes

array of strings

length ≥ 1

Filters the invoice results to a specified payment method type. The supported value is BCA (Business Credit Account). If you do not specify this parameter, the results include all invoices regardless of payment method.

paymentMethodTypes

nextPageToken

string

A page token returned in the response to your previous request when the number of results exceed the page size. Must be used with the same query parameters as the original request. Changing parameters will result in an error. To get the next page of results, include nextPageToken as a parameter. There are no more pages to return when the response returns no nextPageToken.

Responses

200Invoices were successfully retrieved.

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

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.