Developer Console

Earnings Reports

Use the Appstore Developer Console to review and download earnings reports for your apps.

Access Earnings Reports from Developer Console

To access the earnings reports from the Developer Console:

  1. On the Developer Console dashboard page, click the Reporting tab.
  2. In the left menu, click Financials>Earnings & Payments.

Earnings and Payments Reports Page

For the year that you select, you can view the reports by Months (the default) or by Marketplace.

When you expand a section, the table contains entries for each marketplace (in the Month view) or each month (in the Marketplace view). The fields in the table correspond to the fields in the CSV file (see table below).

Multiple line items within a given month can have the same payment amount in the preferred currency, as a single payment can include multiple invoices. The payment date captures the date of payment ( when payment is issued or rejected). It also shows the payment status: The valid values for payment status include:

  • issued
  • not issued
  • rejected

Downloadable Earnings Reports

Use the following steps to download reports:

  1. Select Download Center in the left menu
  2. Click the type of the reports you want to download.
  3. Click the month of the report you want to download, or you can download the reports for a whole year (Earnings and Payments reports only).

Unlike the sales report, numbers in the earnings report are not estimated. They are the approved earnings by Amazon/Twitch. Payment reports are generated based on actual disbursement of payments. Earnings and Payments reports provide you the actual monetary value that you will receive.

Earnings reports display invoices generated at the end of the month, earnings amount before taxes and adjustments, the taxes withheld, any adjustments, payment status, payment amount and payment date.

Earnings that do not meet the payment threshold will accrue in Amazon’s accounts payable records as a carryover balance. The carryover balance plus the current month earnings must exceed the payment threshold before Amazon will initiate a payment.

Earnings reports may not reflect the actual disbursement amounts, such as when payment thresholds have not been met.

Fields in the Earnings and Payments Reports

The CSV file is a text file with a .csv file extension. The CSV file must use UTF-8 encoding to support localized strings.

The CSV file contains one header row (which displays the column titles). Each subsequent row in the file contains the information for one report item.

The following table describes the fields for each entry (row) in the file:

Field Type Description Example
Marketplace String The Amazon marketplace. Amazon.com
Invoice Group ID String The unique Id for the invoice. 8dd921637-b092f385a7ee4-62c6494b3ed702f113
Invoice ID String The sub invoice Id for the invoice. Default value is "NA"
Payment ID Integer The unique Id associated with this payment. 119399812
Earning Period Start Date String The date and time of the start of the earning period. Format is YYYY-MM-DD HH:MM:SS XST, with 00-23 as the range of hours. Times are shown in the in the time zone associated with the marketplace of the transaction. 2017-11-01 00:00:00 EDT
Earning Period End Date String The date and time of the end of the earning period. Format is YYYY-MM-DD HH:MM:SS XST, with 00-23 as the range of hours. Times are shown in the in the time zone associated with the marketplace of the transaction. 2017-12-01 00:00:00 EDT
Earnings Pre-Tax and Adjustments Number (currency) Earnings amount during the earning period. 218.92
Earnings Pre-Tax and Adjustments Currency String Three letter currency value of the earnings amount. EUR
Adjustments Number (currency) Adjustments to the earnings. 218.92
Adjustments Currency String Three letter currency of the adjustments value. EUR
Tax Withheld Number (currency) Amount of tax withheld from the earnings. 218.92
Tax Withheld Currency String Three letter currency of the Tax Withheld value. EUR
Exchange Rate Number Exchange rate used to convert the earnings amount into the home currency. 0.88804
Mode of Payment String The type of the payment. Values include EFT, Check, or Wire EFT
Payment Amount Number (currency) Payment amount in your preferred currency. 218.92
Payment Amount Currency String Three letter currency of the Payment Amount value. GBP
Payment Status String Status of the payment. Values include Issued, Not Issued, and Rejected Issued
Payment Issue Date String The date and time when Amazon issued this payment. Format is YYYY-MM-DD HH:MM:SS XST, with 00-23 as the range of hours. Times are shown in the time zone of the associated marketplace. 2017-11-01 00:00:00 EDT
Payment Failure Date String The date that the payment failed to process. 2017-11-01 00:00:00 EDT
Aws Credit Earned Number (currency) AWS credit earnings amount. Ten percent of total earnings for the associated marketplace. Excludes refunds, chargebacks, and Amazon Appstore on Windows transactions. 218.92
Aws Credit Earned Currency String Three letter currency of the AWS credits earned. GBP
fx_rate Number Foreign exchange rate used to convert the AWS credit earnings amount from the home currency into USD. 1.2124
Aws Credit Earned In USD Number (currency) AWS credit earnings amount in USD. 1005.37
AWS Credit Issued Currency String Three letter currency of the AWS credits issued. The value is always USD. USD
Aws Credit Issued in USD Number (currency) Amount of AWS credits issued in USD. 1005.37
Aws Credit Issued Date Time String The date and time of when the AWS credits were issued. Format is YYYY-MM-DD HH:MM:SS XST, with 00-23 as the range of hours. Times are shown in GMT. 2023-01-29 00:00:00 GMT
Credit Status String Status of the AWS credits. Values include Successful and Not Issued. Successful

Last updated: Feb 03, 2023