Skip to main content
The Sales and Trends API lets you download the same reports available in App Store Connect > Sales and Trends: sales summaries, installs, subscriptions, and more. Reports are returned as gzip-compressed TSV files.
Requires a Team (Organization) key — Individual Apple Developer accounts cannot access Sales Reports. You also need your Vendor Number from Agreements, Tax, and Banking.

​
Download Sales Report

GET /v1/connect/sales-reports
Download a Sales and Trends report. The response is a gzip file—save it and decompress to get the TSV.

​
Required Headers

HeaderDescription
X-ASC-Issuer-IdYour Issuer ID
X-ASC-Key-IdYour Key ID
X-ASC-Private-KeyYour private key (PEM)

​
Required Query Parameters

NameTypeDescription
vendorNumberstringYour vendor number (from Agreements, Tax, and Banking)
reportDatestringDate in format based on frequency (see below)
reportTypestringReport type (default: SALES)
frequencystringDAILY, WEEKLY, MONTHLY, YEARLY (default: MONTHLY)

​
Optional Query Parameters

NameTypeDefaultDescription
reportSubTypestringSUMMARYUsually SUMMARY or DETAILED
versionstring1_0Report version (varies by type)

​
Report Date Format

FrequencyFormatExample
DAILYYYYY-MM-DD2026-03-08
WEEKLYYYYY-MM-DD2026-03-02
MONTHLYYYYY-MM2026-02
YEARLYYYYY2026

​
Report Types & Valid Combinations

reportTypereportSubTypefrequencyversion
SALESSUMMARYDAILY, WEEKLY, MONTHLY, YEARLY1_0
INSTALLSSUMMARYMONTHLY1_2
INSTALLSDETAILEDMONTHLY1_2
INSTALLSSUMMARY_CHANNELYEARLY1_0, 1_1
SUBSCRIPTIONSUMMARYDAILY1_3
SUBSCRIBERDETAILEDDAILY1_3
SUBSCRIPTION_EVENTSUMMARYDAILY1_3
PRE_ORDERSUMMARYDAILY, WEEKLY, MONTHLY, YEARLY1_0
See Apple’s documentation for the full matrix.

​
Response

The API returns the raw gzip file. Save it with a .tsv.gz extension and decompress: 
# Download and save
curl -o sales-2026-02.tsv.gz "https://api.appeeky.com/v1/connect/sales-reports?vendorNumber=XXXXX&reportDate=2026-02&reportType=SALES&frequency=MONTHLY" \
  -H "X-API-Key: YOUR_KEY" \
  -H "X-ASC-Issuer-Id: ..." \
  -H "X-ASC-Key-Id: ..." \
  -H "X-ASC-Private-Key: ..."

# Decompress
gunzip sales-2026-02.tsv.gz

# View (TSV format)
head sales-2026-02.tsv

​
Code Example

# Monthly sales summary
curl -o sales.tsv.gz "https://api.appeeky.com/v1/connect/sales-reports?vendorNumber=12345678&reportDate=2026-02&reportType=SALES&frequency=MONTHLY&reportSubType=SUMMARY&version=1_0" \
  -H "X-API-Key: YOUR_APEEKY_KEY" \
  -H "X-ASC-Issuer-Id: YOUR_ISSUER_ID" \
  -H "X-ASC-Key-Id: YOUR_KEY_ID" \
  -H "X-ASC-Private-Key: YOUR_PRIVATE_KEY"

​
Finding Your Vendor Number

  1. Go to App Store Connect
  2. Agreements, Tax, and Banking
  3. Under Paid Apps or In-App Purchases, find your Vendor Number (numeric, e.g. 12345678)

​
Credits

EndpointCredits
GET /connect/sales-reports3