Contents

Read a List of Instances of a Report

Read list of all the granularity options for a specific type of analytics report.

URL

GET https://api.appstoreconnect.apple.com/v1/analyticsReports/{id}/instances

Path Parameters

NameTypeDescription
id Requiredstring

An opaque resource ID that uniquely identifies the resource. Obtain the analytics report resource ID from the Read Reports for a Specific Request response.

Query Parameters

NameTypeDescription
fields[analyticsReportInstances] Optional[string]

Additional fields to include for each analytics report instances resource returned by the response.

filter[granularity] Optional[string]

Filter the returned report instances by granularity.

filter[processingDate] Optional[string]

Filter the returned report instances by processing date. Use ISO 8601 YYYY-MM-DD format.

limit Optionalinteger

The maximum number of analytics report instances resources to return.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
AnalyticsReportInstancesResponse

400Bad Request
Content-Type: application/json
ErrorResponse

401Unauthorized
Content-Type: application/json
ErrorResponse

403Forbidden
Content-Type: application/json
ErrorResponse

404Not Found
Content-Type: application/json
ErrorResponse

429
Content-Type: application/json
ErrorResponse

Mentioned in

Discussion

Examples Request and Response

See Also

Reading Reports, Instances, and Segments