---
title: "GET /dimensions/{name}"
method: GET
path: "/dimensions/{name}"
---

# GET /dimensions/{name}

`GET /dimensions/{name}`

Provides details about a dimension that is defined in your Amazon Web Services accounts.

Requires permission to access the [DescribeDimension](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `name` string, required

## Response `200`

Success

- DescribeDimensionResponse
  - `name` string — The unique identifier for the dimension.
  - `arn` string — The Amazon Resource Name (ARN) for the dimension.
  - `type` 'TOPIC_FILTER' — The type of the dimension.
  - `stringValues` DimensionStringValue[] — The value or list of values used to scope the dimension. For example, for topic filters, this is the pattern used to match the MQTT topic name.
  - `creationDate` string, date-time — The date the dimension was created.
  - `lastModifiedDate` string, date-time — The date the dimension was last modified.

## Other responses

- `480` — InternalFailureException
- `481` — InvalidRequestException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/iot.md) · [All operations](https://skmtc.net/aws/apis/iot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot/versions/deef5c4b09f0/schema)