# Get provider cost dimensions

> The groupings, filters and cost metrics the provider's cost breakdown answers, each under the name the provider gives it. The dashboard builds the Cost Breakdown's menus from this.

Source: https://docs.levelfour.ai/api-reference/providers/get-providers-by-id-costs-dimensions


## GET /api/v1/providers/{provider_id}/costs/dimensions

The groupings, filters and cost metrics the provider's cost breakdown answers, each under the name the provider gives it. The dashboard builds the Cost Breakdown's menus from this.

### Authentication

Send `Authorization: Bearer <token>`.

### Parameters

- `provider_id` (path, string, required)

### Responses

#### 200: Successful Response

- `success` (boolean, default `true`)
- `timestamp` (date-time string)
- `data` (object, required)
  - `provider_id` (string, required)
  - `group_by` (array of object, required)
    - `key` (string, required): The group_by value the breakdown accepts
    - `label` (string, required): What the provider calls this dimension
    - `table` (boolean, required): Whether the breakdown table groups by it
    - `chart` (boolean, required): Whether the breakdown chart groups by it
  - `filters` (array of object, required)
    - `key` (string, required): The breakdown query parameter
    - `label` (string, required): What the provider calls this dimension
    - `options_key` (string, required): The filter-options field that lists its values
  - `cost_metrics` (array of object, required): The show_cost_as values the provider answers; one means there is no choice to offer
    - `key` (string, required): The show_cost_as value
    - `label` (string, required)
  - `credits_basis` (boolean, required): Whether the before/after credits toggle applies

#### Errors

- `400`: Bad Request
- `401`: Authentication Error
- `403`: Authorization Error
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

Body of `400`, `401`, `403`, `404`, `409`, `422`, `429`, `500`:

- `success` (`false`, required)
- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `details` (any)
- `timestamp` (date-time string, required)