get_sales_report
Download and parse sales reports from App Store Connect, returning structured rows of tab-delimited data. Supports various report types and frequencies.
Instructions
Download and parse a sales report from App Store Connect. Returns tab-delimited report data as structured rows. Your vendor number can be found in App Store Connect under Settings > Agreements, Tax, and Banking. Valid report type and sub-type combinations: SALES + SUMMARY (daily/weekly/monthly/yearly), SUBSCRIPTION + SUMMARY (daily), SUBSCRIPTION_EVENT + SUMMARY (daily), SUBSCRIBER + DETAILED (daily), PRE_ORDER + SUMMARY (daily/weekly/monthly). Report date format varies by frequency: DAILY = YYYY-MM-DD, WEEKLY = YYYY-MM-DD (Sunday start), MONTHLY = YYYY-MM, YEARLY = YYYY.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"vendorNumber": "<vendorNumber>",
"reportType": "<reportType>",
"reportSubType": "<reportSubType>",
"frequency": "<frequency>",
"reportDate": "<reportDate>"
},
"name": "get_sales_report"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vendorNumber | Yes | Your vendor number (numeric string). Found in App Store Connect → Settings → Agreements, Tax, and Banking. | |
| reportType | Yes | The type of sales report to download. | |
| reportSubType | Yes | The sub-type of the report. SUMMARY is most common. DETAILED is for SUBSCRIBER reports. OPT_IN is for opt-in reports. | |
| frequency | Yes | Report frequency. Not all frequencies are valid for all report types. DAILY is the most commonly available. | |
| reportDate | Yes | The date for the report. Format depends on frequency: DAILY = YYYY-MM-DD, WEEKLY = YYYY-MM-DD (Sunday start), MONTHLY = YYYY-MM, YEARLY = YYYY. | |
| reportVersion | No | Optional report version string (e.g., '1_3'). Defaults to latest version. | |
| maxRows | No | Maximum number of data rows to return (1-1000, default 100). |