Parsequerade / docs
Apps
GET/apps/{appId}/metrics/beta-tester-usages

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/metrics/beta-tester-usages?groupBy=betaTesters&period=P30D" \
  -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
periodOptionalstringThe reporting interval used for these metrics.
ValuesP7D, P30D, P90D, P365D
groupByOptionalstringGroup measurements by the supported dimension. Multiple values are comma-separated.
ValuesbetaTesters
betaTestersOptionalstringSelect the beta testers whose metrics should be returned.
limitOptional · Default 50integerNumber of items per page, from 1 to 200.
cursorOptionalstringOpaque nextCursor from a previous response. Keep the route, connection, filters, and ordering unchanged.

Response

Structured metric data, with series and dimension values preserved. Pages use items and nextCursor.

200 · application/json
{
  "items": [
    {
      "dataPoints": [
        {
          "start": "2026-10-14T12:00:00Z",
          "end": "2026-10-14T12:00:00Z",
          "values": {
            "crashCount": 1,
            "sessionCount": 1,
            "feedbackCount": 1
          }
        }
      ],
      "dimensions": {
        "betaTesters": {
          "id": "resource_123"
        }
      }
    }
  ],
  "nextCursor": null
}

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

Response fields

NameTypeDescription
itemsobject[]The current page of plain resource objects. An empty collection returns [].
nextCursorstring | nullOpaque continuation token, or null when the collection is complete. Pass it back as cursor.

Each item

NameTypeDescription
dataPointsobject[]Measurements for this dimension, including the start and end of each reporting interval.
dimensionsobjectPlain identifiers for the entities represented by these measurements.
dataPoints fields
NameTypeDescription
startOptionalstring · date-timeStart, as an RFC 3339 timestamp.
endOptionalstring · date-timeEnd, as an RFC 3339 timestamp.
valuesOptionalobjectThe values value reported by Apple for this resource.
dataPoints.values fields
NameTypeDescription
crashCountOptionalintegerThe crash count value reported by Apple for this resource.
sessionCountOptionalintegerThe session count value reported by Apple for this resource.
feedbackCountOptionalintegerThe feedback count value reported by Apple for this resource.
dimensions fields
NameTypeDescription
betaTestersOptionalobjectThe beta testers value reported by Apple for this resource.
dimensions.betaTesters fields
NameTypeDescription
idOptionalstringApple’s resource ID. Keep this string unchanged when addressing a resource.

Behavior

  • Provide either groupBy or betaTesters. Apple requires at least one of these parameters.

Pagination

Pass nextCursor back as cursor with the same filters and ordering. Stop when it is null. Each request returns one bounded page; the service never reports a capped or incomplete traversal as a complete collection.

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}/metrics/betaTesterUsages. Read Apple’s original endpoint ↗

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

Facade parameterTypeDescription
periodqueryperiod
groupByquerygroupBy
betaTestersqueryfilter[betaTesters]
limitquerylimit
cursorqueryFacade-owned pagination

Reviewed 2026-10-14 · OpenAPI 4.5.1