---
title: "Retrieve a cube value range with structured headers"
method: GET
path: "/ranges/{id}/dimensions"
tags: ["Cube Value Range"]
---

# Retrieve a cube value range with structured headers

`GET /ranges/{id}/dimensions`

Return the cube value range with its `headers` field represented as structured row/column dimensions.

- Unlike `retrieve` and `a1`, this endpoint organizes headers by their underlying dimensions.
- Use this when you need explicit row/column headers instead of A1 notation.

## Path parameters

- `id` string, required

## Headers

- `X-Company-ID` string, required

## Response `200`

- RowColumnCubeValueRange — Mixin to delegate create, update, and destroy operations to a service class.
  - `id` integer, required
  - `headers` object, required
  - `data` unknown
  - `filters` unknown, required
  - `range_type` 'PIVOT' | 'DRILLDOWN' — * `PIVOT` - Pivot * `DRILLDOWN` - Drilldown
  - `name` string, nullable
  - `fetch_enabled` boolean
  - `publish_enabled` boolean
  - `row_discovery_enabled` boolean
  - `currency` CurrencyNested
    - `id` integer, required
    - `name` string, required
    - `code` string, required
  - `exclude_zeros` boolean
  - `suppressed_row_dimensions` unknown
  - `created_by_id` integer, nullable, required
  - `collapse_coordinates` array[]
    - integer[]
  - `expand_all_coordinates` array[]
    - integer[]
  - `expand_coordinates` array[]
    - integer[]
  - `tags` unknown

---

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