---
title: "GET /v2/billing/dimensions"
method: GET
path: "/v2/billing/dimensions"
tags: ["billing"]
---

# GET /v2/billing/dimensions

`GET /v2/billing/dimensions`

This API will return a list of dimensions available for use in the `getBillingCosts` API and in CostFormation.

## Query parameters

- `include_hidden` boolean

## Response `200`

Successful Operation

- object
  - `dimensions` BillingDimension[]
    - `id` string — Identifier of a CloudZero Dimension, as used in the CostFormation language. See https://docs.cloudzero.com/docs/dimensions for details.
    - `name` string

## Other responses

- `400` — Bad Request Error
- `403` — Forbidden
- `410` — Expired Cache Error
- `429` — Rate Limit Error

---

[API](https://skmtc.dev/cloudzero/apis/cloudzero-api-v2-resources.md) · [All operations](https://skmtc.dev/cloudzero/apis/cloudzero-api-v2-resources/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudzero/cloudzero-api-v2-resources/revisions/fd805a0e75e5/schema)