---
title: "GET /api/v1/metrics/checks/dimensions/"
method: GET
path: "/api/v1/metrics/checks/dimensions/"
tags: ["metrics"]
---

# GET /api/v1/metrics/checks/dimensions/

`GET /api/v1/metrics/checks/dimensions/`

## Request

- Base URL: `https://uptime.com` (the document declares no server; this is the origin it was published from)
- URL: `https://uptime.com/api/v1/metrics/checks/dimensions/`
- Auth: none declared
- TypeScript: <https://skmtc.dev/uptime/apis/uptime-com-openapi-schema/docs/api/v1/metrics/checks/dimensions/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the distinct values present in the data for the requested dimension.

Used to populate filter/group-by dropdowns in clients. Works for any dimension
listed in the schema for the data type. For synthetic data types (``float``,
``int``, ``string``), only common dimensions (``location``, etc.) are available.

## Query parameters

- `check_id` integer, required
- `data_type` string, required
- `dimension` string, required
- `start_date` string
- `end_date` string

## Response `200`

- MetricsDimensions
  - `check_id` integer, required: The check to query.
  - `data_type` string, required: MDB data type (e.g. ``http``, ``pagespeed``, ``float``). Required.
  - `dimension` string, required: Dimension name to enumerate values for (e.g. ``location``, ``step_number``). Must be a dimension listed in the schema for the data type.
  - `start_date` string, date-time: Range start (ISO 8601, UTC). Defaults to 24 hours ago.
  - `end_date` string, date-time: Range end (ISO 8601, UTC). Defaults to now.

---

[API](https://skmtc.dev/uptime/apis/uptime-com-openapi-schema.md) - [All operations](https://skmtc.dev/uptime/apis/uptime-com-openapi-schema/llms.txt) - [OpenAPI document](https://skmtc.dev/uptime/apis/uptime-com-openapi-schema/revisions/e1e4a57a60d8?raw)