getInvoiceHeaders

get

https://sellingpartnerapi-na.amazon.com/finances/invoices/2026-06-25/invoices

Returns invoice headers for all invoices matching filters that you specify.

Query Params

nextToken

string

The response includes nextToken when the number of invoices exceeds the default page size value (100). To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until nextToken is null. Note that this operation can return empty pages.

marketplaceId

string

required

The marketplace ID of the marketplace from which you want to retrieve invoice headers. The marketplace ID is a globally unique identifier used to specify which Amazon marketplace a request is targeting. For more information, refer to Marketplace IDs.

fromIssueDate

date-time

Retrieve invoice headers issued after this date. The range between fromIssueDate and toIssueDate must not exceed 90 days. Either provide both dates or leave both empty. If you do not provide these dates, fromIssueDate defaults to 90 days before the date of the request. In ISO 8601 date-time format.

toIssueDate

date-time

Retrieve invoice headers issued before this date. The range between fromIssueDate and toIssueDate must not exceed 90 days. Either provide both dates or leave both empty. If you do not provide these dates, toIssueDate defaults to the date of the request. In ISO 8601 date-time format.

invoicesModifiedAfter

date-time

Retrieve invoices that were modified after this date-time. In ISO 8601 date-time format.

Responses

Language

Loading…

Response

Choose an example:

application/json

200Success.

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.