---
title: "List DQ dimensions"
method: GET
path: "/data-quality/v1/dq-dimensions"
tags: ["Data Quality Dimensions"]
---

# List DQ dimensions

`GET /data-quality/v1/dq-dimensions`

## Request

- Base URL: `https://your-environment.ataccama.one/api`
- URL: `https://your-environment.ataccama.one/api/data-quality/v1/dq-dimensions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/docs/data-quality/v1/dq-dimensions/get.ts> (a function with typed inputs; its response is checked against the schema)

List the DQ dimensions in your environment, together with their dimension results.

The endpoint returns published dimensions only.

In the response, each dimension carries:

- `urn`: The dimension's URN, referenced as `dqDimensionUrn` in rule implementations.
- `results`: All dimension results of the dimension, stored inline. The `urn` of a result is what
  rule conditions and fallbacks reference as `resultUrn`.
- `defaultConditionResultUrn` and `defaultFallbackResultUrn`: The results assigned by default to
  conditions and fallbacks in that dimension.

Paging is forward-only.

## Query parameters

- `after` string
- `size` integer
- `sort` string

## Response `200`

Paginated list of DQ dimensions.

- object
  - `meta` PaginationMetadata, required
    - `next` string: Encoded string representing the next page. Omitted if there are no more pages.
    - `total` integer: Total number of items available across all pages.
  - `data` DqDimensionResponse[], required
    - `urn` string, uri, required: A URN identifying the DQ dimension resource in the Data Quality API. Format: urn:ata:{tenant}:data-quality:dq-dimension:{uuid} Example: urn:ata:acme-corp:data-quality:dq-dimension:123e4567-e89b-12d3-a456-426614174000.
    - `name` string, required: Display name of the DQ dimension.
    - `abbreviation` string, required: Short form of the name, used where there is no room for the full one.
    - `description` string, nullable: Free-text description of the DQ dimension.
    - `color` string, required: Colour used to render the dimension, as a hexadecimal RGB value.
    - `order` integer, required: Position of the dimension among all dimensions, ascending.
    - `active` boolean, required: Whether the dimension can be selected when creating new rules.
    - `overallContribution` boolean, required: Whether results in this dimension contribute to the overall quality evaluation.
    - `defaultConditionResultUrn` string, uri, required: A URN identifying the DQ dimension result resource in the Data Quality API. Format: urn:ata:{tenant}:data-quality:dq-dimension-result:{uuid} Example: urn:ata:acme-corp:data-quality:dq-dimension-result:123e4567-e89b-12d3-a456-426614174000.
    - `defaultFallbackResultUrn` string, uri, required: A URN identifying the DQ dimension result resource in the Data Quality API. Format: urn:ata:{tenant}:data-quality:dq-dimension-result:{uuid} Example: urn:ata:acme-corp:data-quality:dq-dimension-result:123e4567-e89b-12d3-a456-426614174000.
    - `results` object, required: All results the dimension can produce, keyed by their id (UUID) and ordered by the `order` property of each result.

## Other responses

- `400`: Bad request. The request parameters or body are invalid.
- `403`: Forbidden. You do not have permission to access the requested resource.

---

[API](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api.md) - [All operations](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/revisions/46f16e0487f8?raw)