Retrieve invoice headers

Learn how to search for and list invoices that match specific filters, such as date range and marketplace. Use this tutorial to identify invoices within a billing period, track invoice statuses, and find related identifiers such as purchase orders, payment IDs to help you reconcile across the full invoice lifecycle.

Prerequisites

To complete this tutorial, you must have:

• Authorization from the selling partner for whom you are making calls. Refer to the Authorizing Selling Partner API applications for more information.
• Approval for the Finance and Accounting role in your developer profile.
• The Finance and Accounting role selected in the App registration page for your application.

Step 1. Retrieve invoice headers

Call the getInvoiceHeaders operation with the marketplaceId of the Amazon store to which the invoice belongs. You may optionally include the following parameters to further filter the results:

• fromIssueDate: Retrieve invoices issued after this date.
• toIssueDate: Retrieve invoices issued before this date.
• invoicesModifiedAfter: Retrieve invoices that were modified after this date-time.

The range between fromIssueDate and toIssueDate must not exceed 90 days. If you do not provide these dates, fromIssueDate defaults to 90 days before the current date.

The response includes a list of invoice headers that match your specified filters.