--- title: Download sales and trends reports framework: appstoreconnectapi role: symbol role_heading: Web Service Endpoint path: appstoreconnectapi/get-v1-salesreports --- # Download sales and trends reports Download sales and trends reports filtered by your specified criteria. ## URL GET https://api.appstoreconnect.apple.com/v1/salesReports ## Query Parameters filter[frequency]: Frequency of the report to download. For a list of values, see Allowed values based on sales report type table below. filter[reportDate]: The report date to download. Specify the date in the YYYY-MM-DD format for all report frequencies except DAILY, which doesn’t require a date. For more information, see report availability and storage. filter[reportSubType]: The report sub type to download. For a list of values, see Allowed values based on sales report type table below. filter[reportType]: The report to download. For more details on each report type see Download and view reports. filter[vendorNumber]: You can find your vendor number in View payments and proceeds. filter[version]: The version of the report. For a list of values, see Allowed values based on sales report type table below. ## Response Codes 200 OK: The request completed successfully. 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 429 : ## Mentioned in App Store Connect API 1.8 release notes App Store Connect API 3.2 release notes App Store Connect API 3.4 release notes App Store Connect API 3.6 release notes App Store Connect API 3.7 release notes Downloading Analytics Reports ## Discussion Discussion Allowed values based on sales report type Each sales report type has specific valid values for reportType, reportSubType, frequency, and version. If you use other types, it results in an error. For more details on each report type, see Download and view reports. note: Version 1_2 of the Subscription, Subscription Event, and Subscriber reports in Sales and Trends is no longer available for download. | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ## See Also ### Downloading Reports - [Download finance reports](appstoreconnectapi/get-v1-financereports.md)