Download App Store Connect sales, subscription and finance reports and parse the gzipped TSV payloads

Documented steps

1. Authenticate with Authorization: Bearer <JWT> on every request.
2. Call GET https://api.appstoreconnect.apple.com/v1/salesReports with the four REQUIRED params: filter[frequency], filter[reportType], filter[reportSubType], filter[vendorNumber].
3. filter[frequency] enum: DAILY, WEEKLY, MONTHLY, YEARLY.
4. filter[reportType] enum: SALES, PRE_ORDER, NEWSSTAND, SUBSCRIPTION, SUBSCRIPTION_EVENT, SUBSCRIBER, SUBSCRIPTION_OFFER_CODE_REDEMPTION, INSTALLS, FIRST_ANNUAL, WIN_BACK_ELIGIBILITY.
5. filter[reportSubType] enum: SUMMARY, DETAILED, SUMMARY_INSTALL_TYPE, SUMMARY_TERRITORY, SUMMARY_CHANNEL.
6. Add filter[reportDate]=YYYY-MM-DD for WEEKLY/MONTHLY/YEARLY frequencies. Optionally add filter[version] to pin the report schema version.
7. Send header Accept: application/a-gzip. A 200 response has Content-Type: application/a-gzip and a gzip body — it is NOT JSON.
8. curl -H "Authorization: Bearer $JWT" -H "Accept: application/a-gzip" "https://api.appstoreconnect.apple.com/v1/salesReports?filter[frequency]=DAILY&filter[reportType]=SALES&filter[reportSubType]=SUMMARY&filter[vendorNumber]=$VENDOR" -o report.gz
9. For subscription analytics use reportType SUBSCRIPTION (state snapshot), SUBSCRIPTION_EVENT (churn/renewal events) or SUBSCRIBER (subscriber-level detail).
10. Decompress with gzip (Python gzip.decompress, or gunzip) to get a tab-separated file. The first line is the column header row; split subsequent lines on \t.
11. For finance data call GET https://api.appstoreconnect.apple.com/v1/financeReports with required params filter[regionCode], filter[reportDate]=YYYY-MM, filter[reportType] (FINANCIAL or FINANCE_DETAIL) and filter[vendorNumber], with the same Accept: application/a-gzip header.
12. curl -H "Authorization: Bearer $JWT" -H "Accept: application/a-gzip" "https://api.appstoreconnect.apple.com/v1/financeReports?filter[regionCode]=ZZ&filter[reportDate]=2026-06&filter[reportType]=FINANCIAL&filter[vendorNumber]=$VENDOR" -o finance.gz
13. Branch on status code or Content-Type BEFORE gunzipping: 4xx/429 responses come back as JSON ErrorResponse bodies even though success is binary gzip.
14. Back off on 429 using the X-Rate-Limit header (format user-hour-lim:<N>;user-hour-rem:<M>) rather than retrying blind.
15. Official docs: https://developer.apple.com/documentation/appstoreconnectapi/get-v1-salesreports | https://developer.apple.com/documentation/appstoreconnectapi/get-v1-financereports | https://developer.apple.com/help/app-store-connect/getting-paid/download-financial-reports/