---
title: "Queries dimension values for a universe."
method: POST
path: "/analytics-query-api/v1/universes/{universeId}/dimension-values"
tags: ["Analytics"]
---

# Queries dimension values for a universe.

`POST /analytics-query-api/v1/universes/{universeId}/dimension-values`

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

## Path parameters

- `universeId` integer, required

## Request body

- AnalyticsQueryPublicApiDimensionValuesRequest — A request to query dimension values.
  - `metric` string, required — The metric that provides context for resolving dimension namespaces.
  - `dimensions` string[] — The dimensions to retrieve values for. Each entry is a single dimension name.
  - `startTime` string, date-time, required — The inclusive start of the query time range. Any UTC offset is accepted; results are always bucketed in UTC.
  - `endTime` string, date-time, required — The exclusive end of the query time range. Any UTC offset is accepted; results are always bucketed in UTC.
  - `filter` AnalyticsQueryPublicApiQueryFilter[] — Filters to apply to the query.
    - `dimension` string, required — The dimension name to filter on.
    - `values` string[] — The values to filter by.
    - `operation` 'In' | 'NotIn' | 'GreaterThan' | 'GreaterThanOrEqual' | 'LessThan' | 'LessThanOrEqual' | 'Match', required — The operation to apply to a query filter.
  - `granularity` 'OneMinute' | 'HalfHour' | 'OneHour' | 'OneDay' | 'OneWeek' | 'OneMonth' | 'None' — The time granularity of metric data points in a query.
  - `limit` integer — The maximum number of values to return per dimension.

## Response `200`

OK

- DimensionValuesOperationResult — A completed long-running dimension values 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` AnalyticsQueryPublicApiDimensionValuesResponse — The response for a dimension values query.
    - `values` AnalyticsQueryPublicApiDimensionValues[] — The dimension values returned by the query.
      - `dimension` string, required — The dimension name.
      - `values` DimensionValue[] — The values for the dimension.
        - `value` string, required — The dimension value.
        - `displayValue` string, nullable — A human-readable display value when the dimension is a unique ID.
  - `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
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.net/roblox/apis/roblox-api.md) · [All operations](https://skmtc.net/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roblox/roblox-api/revisions/958b2b40425d/schema)