---
title: "Get the user's replay data"
framework: Apple Music API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple music 1.0+]
path: "applemusicapi/get-the-user's-replay-data"
---

# Get the user's replay data

Fetch the user’s replay data for the latest eligible year.

## URL

GET https://api.music.apple.com/v1/me/music-summaries

## Query Parameters

extend: A list of attribute extensions applied to resources in the response. filter[year]: A filter applied to the request. The value is always latest. include: A list of relationship names to include for resouces in the response. l: The localization specified by a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefront object specified by the storefront. Otherwise, the storefront’s defaultLanguageTag is used. views: The views to activate for the music summaries resource.

## Response Codes

200 OK: The request was successful. 401 Unauthorized: A response indicating an incorrect Authorization header. 403 Forbidden: A response indicating invalid or insufficient authentication. 500 Internal Server Error: A response indicating an error occurred on the server.

## Discussion

Discussion A successful HTTP request returns music summaries for the most recent year that the user has enough listening history. If unsuccessful, the HTTP status code indicates the error, and the details are in the errors array. For more information, see Handling Requests and Responses.