---
title: Read a List of Instances of a Report
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-analyticsreports-_id_-instances
---

# 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

id: 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

fields[analyticsReportInstances]: Additional fields to include for each analytics report instances resource returned by the response. filter[granularity]: Filter the returned report instances by granularity. filter[processingDate]: Filter the returned report instances by processing date. Use ISO 8601 YYYY-MM-DD format. limit: The maximum number of analytics report instances resources to return.

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 :

## Mentioned in

Downloading Analytics Reports

## Discussion

Discussion Examples Request and Response

## See Also

### Reading Reports, Instances, and Segments

- [Read Report Information](appstoreconnectapi/get-v1-analyticsreports-_id_.md)
- [Read Report Instance Information](appstoreconnectapi/get-v1-analyticsreportinstances-_id_.md)
- [Read the Segments for a Report](appstoreconnectapi/get-v1-analyticsreportinstances-_id_-segments.md)
- [Read segment ids for a report](appstoreconnectapi/get-v1-analyticsreportinstances-_id_-relationships-segments.md)
- [Read the Details for a Report Segment](appstoreconnectapi/get-v1-analyticsreportsegments-_id_.md)
- [Read a list of a report instance ids](appstoreconnectapi/get-v1-analyticsreports-_id_-relationships-instances.md)