Parsequerade / docs
Apps
GET/apps/{appId}/power-performance-metrics

Proposed · Extended read design · Adapter not implemented

Request

Routes are relative to your connection. Use a facade API key; the service manages Apple authentication.

cURL
BASE='https://asc.example.com/v1/connections/conn_example'

curl --fail-with-body "$BASE/apps/1234567890/power-performance-metrics" \
  -H "Authorization: Bearer $ASC_FACADE_KEY"

asc.example.com is a placeholder for your deployment. Examples use fictional IDs.

Path parameters

NameTypeDescription
appIdRequiredstringApple’s app ID. Returned by List apps.

Query parameters

NameTypeDescription
platformOptionalstringRestrict results to the specified Apple platforms. Multiple values are comma-separated.
ValuesIOS
metricTypeOptionalstringFilter by metric type. Multiple values are comma-separated.
ValuesDISK, HANG, BATTERY, LAUNCH, MEMORY, ANIMATION, TERMINATION, STORAGE
deviceTypeOptionalstringFilter by device type. Multiple values are comma-separated.

Response

Structured metric data, with series and dimension values preserved.

200 · application/json
{
  "version": "1.0",
  "insights": {
    "trendingUp": [
      {
        "metricCategory": "HANG",
        "latestVersion": "latest_version_example",
        "metric": "metric_example",
        "summaryString": "summary_string_example",
        "referenceVersions": "reference_versions_example",
        "maxLatestVersionValue": 1
      }
    ],
    "regressions": [
      {
        "metricCategory": "HANG",
        "latestVersion": "latest_version_example",
        "metric": "metric_example",
        "summaryString": "summary_string_example",
        "referenceVersions": "reference_versions_example",
        "maxLatestVersionValue": 1
      }
    ]
  },
  "productData": [
    {
      "platform": "platform_example",
      "metricCategories": [
        {
          "identifier": "HANG",
          "metrics": []
        }
      ]
    }
  ]
}

Illustrative response. Optional read fields may be absent or null; unknown enum values are preserved.

Response fields

NameTypeDescription
versionstringThe format version of this metrics response.
insightsobjectApple’s performance findings for this resource.
productDataobject[]Performance series grouped by product, version, and platform.
insights fields
NameTypeDescription
trendingUpOptionalobject[]The trending up value reported by Apple for this resource.
regressionsOptionalobject[]The regressions value reported by Apple for this resource.
insights.trendingUp fields
NameTypeDescription
metricCategoryOptionalstringThe metric category value reported by Apple for this resource.
ValuesHANG, LAUNCH, MEMORY, DISK, BATTERY, TERMINATION, ANIMATION, STORAGE
latestVersionOptionalstringThe latest version value reported by Apple for this resource.
metricOptionalstringThe metric value reported by Apple for this resource.
summaryStringOptionalstringThe summary string value reported by Apple for this resource.
referenceVersionsOptionalstringThe reference versions value reported by Apple for this resource.
maxLatestVersionValueOptionalnumberThe max latest version value value reported by Apple for this resource.
subSystemLabelOptionalstringThe sub system label value reported by Apple for this resource.
highImpactOptionalbooleanWhether Apple marks this resource as high impact.
populationsOptionalobject[]The populations value reported by Apple for this resource.
insights.trendingUp.populations fields
NameTypeDescription
deltaPercentageOptionalnumberThe delta percentage value reported by Apple for this resource.
percentileOptionalstringThe percentile value reported by Apple for this resource.
summaryStringOptionalstringThe summary string value reported by Apple for this resource.
referenceAverageValueOptionalnumberThe reference average value value reported by Apple for this resource.
latestVersionValueOptionalnumberThe latest version value value reported by Apple for this resource.
deviceOptionalstringThe device value reported by Apple for this resource.
insights.regressions fields
NameTypeDescription
metricCategoryOptionalstringThe metric category value reported by Apple for this resource.
ValuesHANG, LAUNCH, MEMORY, DISK, BATTERY, TERMINATION, ANIMATION, STORAGE
latestVersionOptionalstringThe latest version value reported by Apple for this resource.
metricOptionalstringThe metric value reported by Apple for this resource.
summaryStringOptionalstringThe summary string value reported by Apple for this resource.
referenceVersionsOptionalstringThe reference versions value reported by Apple for this resource.
maxLatestVersionValueOptionalnumberThe max latest version value value reported by Apple for this resource.
subSystemLabelOptionalstringThe sub system label value reported by Apple for this resource.
highImpactOptionalbooleanWhether Apple marks this resource as high impact.
populationsOptionalobject[]The populations value reported by Apple for this resource.
insights.regressions.populations fields
NameTypeDescription
deltaPercentageOptionalnumberThe delta percentage value reported by Apple for this resource.
percentileOptionalstringThe percentile value reported by Apple for this resource.
summaryStringOptionalstringThe summary string value reported by Apple for this resource.
referenceAverageValueOptionalnumberThe reference average value value reported by Apple for this resource.
latestVersionValueOptionalnumberThe latest version value value reported by Apple for this resource.
deviceOptionalstringThe device value reported by Apple for this resource.
productData fields
NameTypeDescription
platformOptionalstringApple’s platform value, preserved without renaming.
metricCategoriesOptionalobject[]The metric categories value reported by Apple for this resource.
productData.metricCategories fields
NameTypeDescription
identifierOptionalstringThe identifier value reported by Apple for this resource.
ValuesHANG, LAUNCH, MEMORY, DISK, BATTERY, TERMINATION, ANIMATION, STORAGE
metricsOptionalobject[]The metrics value reported by Apple for this resource.
productData.metricCategories.metrics fields
NameTypeDescription
identifierOptionalstringThe identifier value reported by Apple for this resource.
goalKeysOptionalobject[]The goal keys value reported by Apple for this resource.
unitOptionalobjectThe unit value reported by Apple for this resource.
datasetsOptionalobject[]The datasets value reported by Apple for this resource.
productData.metricCategories.metrics.goalKeys fields
NameTypeDescription
goalKeyOptionalstringThe goal key value reported by Apple for this resource.
lowerBoundOptionalintegerThe lower bound value reported by Apple for this resource.
upperBoundOptionalintegerThe upper bound value reported by Apple for this resource.
productData.metricCategories.metrics.unit fields
NameTypeDescription
identifierOptionalstringThe identifier value reported by Apple for this resource.
displayNameOptionalstringThe display name value reported by Apple for this resource.
productData.metricCategories.metrics.datasets fields
NameTypeDescription
filterCriteriaOptionalobjectThe filter criteria value reported by Apple for this resource.
pointsOptionalobject[]The points value reported by Apple for this resource.
recommendedMetricGoalOptionalobjectThe recommended metric goal value reported by Apple for this resource.

Behavior

  • A nested resource must belong to the selected parent and the configured connection. The adapter validates ownership before returning data.

Errors

HTTPTypeDescription
400invalid_queryUnsupported filter, sort, limit, or cursor.
401unauthorizedMissing or invalid facade API key.
403forbidden / upstream_forbiddenThe caller or configured Apple key cannot read this resource.
404resource_not_foundThe requested resource, parent, or exact locale is absent or outside the caller’s scope.
429rate_limitedA facade or Apple rate limit was reached. Respect Retry-After when returned.
502–504upstream errorApple authentication, response parsing, availability, or timeout failure; this is not an empty result.

Apple mapping

Upstream route and translation

The adapter calls GET /v1/apps/{id}/perfPowerMetrics. Read Apple’s original endpoint ↗

Apple returns application/vnd.apple.xcode-metrics+json. The adapter retains the metric-series structure, removes transport envelopes where present, and exposes dimension linkage as IDs.

Facade parameterTypeDescription
platformqueryfilter[platform]
metricTypequeryfilter[metricType]
deviceTypequeryfilter[deviceType]

Reviewed 2026-10-14 · OpenAPI 4.5.1