Contents

Get Power and Performance Metrics for an App

Get the performance and power metrics data for the most recent version of an app.

URL

GET https://api.appstoreconnect.apple.com/v1/apps/{id}/perfPowerMetrics

Path Parameters

NameTypeDescription
id Requiredstring

The resource ID that uniquely identifies the app to return metrics data for. Obtain the app resource ID from the List Apps response.

Query Parameters

NameTypeDescription
filter[deviceType] Optional[string]

The device types by which to filter. Use all_iphones for all iPhone models. Use all_ipads for all iPad models.

filter[metricType] Optional[string]

Types of metrics by which to filter. For more information about metric types, see MetricCategory.

filter[platform] Optional[string]

Platforms by which to filter.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/vnd.apple.xcode-metrics+json
xcodeMetrics

400Bad Request
Content-Type: application/json
ErrorResponse

An error occurred with your request.

401Unauthorized
Content-Type: application/json
ErrorResponse

403Forbidden
Content-Type: application/json
ErrorResponse

Request not authorized.

404Not Found
Content-Type: application/json
ErrorResponse

Resource not found.

429
Content-Type: application/json
ErrorResponse

Mentioned in

Discussion

The example below requests iOS app launch metrics on all iPhones for the most-recent app versions. To get metrics for a specific app version instead, use the Get Power and Performance Metrics for a Build endpoint.

Example Request and Response

See Also

Getting Metrics and Diagnostic Logs