---
title: "GET /categories"
method: GET
path: "/categories"
---

# GET /categories

`GET /categories`

## Request

- Base URL: `https://dev-cloud.acronis.com/api/alert_manager/v1`
- URL: `https://dev-cloud.acronis.com/api/alert_manager/v1/categories`
- Auth: OAuth 2
  - Authorization code: `https://dev-cloud.acronis.com/api/2/idp/authorize`
  - Client credentials
  - Password
  - Token URL: `https://dev-cloud.acronis.com/api/2/idp/token` scopes: `urn:acronis.com::alert_manager::viewer`

Fetches a list of enabled categories.

## Query parameters

- `include_disabled` boolean: If true, both enabled and disabled categories are returned.

## Response `200`

A list of categories.

- object
  - `items` Category[], required
    - `name` string, required
    - `disabled` boolean
    - `alias` string: Alert category name alias.

## Other responses

- `401`: Request is refused because authentication parameters are invalid.
- `403`: A security error due to an issue with tenant security claim: invalid tenant in the access token, tenant resolution failed and etc.

---

[API](https://skmtc.dev/acronis/apis/alert-manager-api.md) - [All operations](https://skmtc.dev/acronis/apis/alert-manager-api/llms.txt) - [OpenAPI document](https://skmtc.dev/acronis/apis/alert-manager-api/revisions/540eec169663?raw)