# Filter catalog for tag rules

Source: https://docs.levelfour.ai/api-reference/tags/get-tags-dimensions


## GET /api/v1/tags/dimensions

### Authentication

Send `Authorization: Bearer <token>`.

### Parameters

- `provider` (query, one of `aws`, `gcp`, `digitalocean`, `all`, default `all`)

### Responses

#### 200: Successful Response

- `success` (boolean, default `true`)
- `timestamp` (date-time string)
- `data` (object, required)
  - `operators` (array of one of `is`, `is_not`, `contains`, `not_contains`, `starts_with`, `ends_with`, `flexible_match`, `not_flexible_match`, required)
  - `dimensions` (array of object, required)
    - `id` (one of `account`, `billing_account`, `region`, `service`, `category`, `subcategory`, `usage_unit`, `resource`, `charge_type`, `marketplace`, `tag`, `tagged`, `virtual_tag`, required)
    - `key_mode` (one of `required`, `optional`, `none`, required)
    - `valueless` (boolean, required)
    - `providers` (array of one of `aws`, `gcp`, `digitalocean`, required)
  - `capabilities` (object, required)
    - `gcp_resource_level` (boolean, required)
    - `accounts_without_detailed_data` (array of string, required)

#### 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)
