---
title: Read the Segments for a Report
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-analyticsreportinstances-_id_-segments
---

# Read the Segments for a Report

Get details for a specific analytics report segment.

## URL

GET https://api.appstoreconnect.apple.com/v1/analyticsReportInstances/{id}/segments

## Path Parameters

id: An opaque resource ID that uniquely identifies the resource. Obtain the analytics report instance resource ID from the Read a List of Instances of a Report response.

## Query Parameters

fields[analyticsReportSegments]: Additional fields to include for each analytics report segments resource returned by the response. limit: The maximum number of analytics report segments 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 tip: The download URLs are valid for 5 minutes after generating. You need to download the reports immediately after calling this endpoint. Examples Request and Response

## See Also

### Reading Reports, Instances, and Segments

- [Read Report Information](appstoreconnectapi/get-v1-analyticsreports-_id_.md)
- [Read a List of Instances of a Report](appstoreconnectapi/get-v1-analyticsreports-_id_-instances.md)
- [Read Report Instance Information](appstoreconnectapi/get-v1-analyticsreportinstances-_id_.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)