---
title: "Retrieves the result of a long-running metrics query operation."
method: GET
path: "/analytics-query-api/v1/universes/{universeId}/operations/metrics/{operationId}"
tags: ["Analytics"]
---

# Retrieves the result of a long-running metrics query operation.

`GET /analytics-query-api/v1/universes/{universeId}/operations/metrics/{operationId}`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/analytics-query-api/v1/universes/{universeId}/operations/metrics/{operationId}`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2
    - Authorization code: `https://apis.roblox.com/oauth/v1/authorize`
    - Token URL: `https://apis.roblox.com/oauth/v1/token` scopes: `universe.analytics:read`

See the <a href="https://create.roblox.com/docs/cloud/guides/analytics">Analytics guide</a> for more information.

## Path parameters

- `universeId` integer, required
- `operationId` string, required

## Response `200`

OK

- QueryOperationResult: A completed long-running query operation with results.
  - `path` string, nullable: The server-assigned resource path.
  - `done` boolean: If false, the operation is still in progress. If true, the operation is completed.
  - `response` AnalyticsQueryPublicApiQueryResponse: The response for a metric query.
    - `values` AnalyticsQueryPublicApiMetricValue[]: The metric values returned by the query.
      - `breakdowns` AnalyticsQueryPublicApiBreakdownValue[]: The breakdown values for this series.
        - `dimension` string, required: The dimension name.
        - `value` string, required: The dimension value.
        - `displayValue` string, nullable: A human-readable display value when the dimension is a unique ID.
      - `dataPoints` AnalyticsQueryPublicApiDataPoint[]: The data points for this series.
        - `time` string, date-time, required: The timestamp of the data point in UTC.
        - `value` number, double, required: The numeric value of the data point.
        - `stringValues` string[], nullable: String values associated with the data point, when applicable.
        - `status` 'Valid' | 'Projected' | 'NotStatisticallySignificant': The status of a data point in a query result.
  - `metadata` AnalyticsQueryPublicApiOperationMetadata: The metadata associated with a long-running operation.
    - `createdTime` string, date-time, nullable: The time the operation was created.

## Other responses

- `202`: Accepted
- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable
- `504`: Gateway Timeout

## Changes

- **2026-08-25** `15343b76e5a1`: 1 info
  - the endpoint scheme security `roblox-oauth2` was added to the API

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/analytics-query-api/v1/universes/:universeId/operations/metrics/:operationId/get.md)

---

[API](https://skmtc.dev/roblox/apis/roblox-api.md) - [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roblox/apis/roblox-api/revisions/bcfdc20689cd?raw)
