# Get severity levels

Retrieve the severity levels configured for the organization.

Source: https://statusdashboard.com/docs/api/event-management/severities/get

`GET /app/severities`

Returns the tenant's custom severity level configuration.

***

## Request
See [API Basics](/docs/api) for required headers.

This endpoint takes no request body or query parameters.

***

## Sample request
```bash
curl https://api.statusdashboard.com/app/severities \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

## Sample response
**Status: `200 OK`**

```json
{
  "severities": [
    {
      "label": "Degraded Performance",
      "description": "Minor service issues, some users may see slow performance.",
      "icon": "alert-triangle",
      "defaultColor": "#CA8A04",
      "order": 1
    },
    {
      "label": "Partial Outage",
      "description": "A major feature or part of the service is unavailable.",
      "icon": "alert-circle",
      "defaultColor": "#EA580C",
      "order": 2
    },
    {
      "label": "Major Outage",
      "description": "A critical service is completely down or all users are affected.",
      "icon": "alert-octagon",
      "defaultColor": "#991B1B",
      "order": 3
    }
  ],
  "limits": {
    "severityLevels": 6
  }
}
```

***

## Response fields
| Field                       | Type   | Description                                                                     |
| --------------------------- | ------ | ------------------------------------------------------------------------------- |
| `severities`                | array  | Ordered array of severity level objects (sorted by `order` ascending).          |
| `severities[].label`        | string | Display name of the severity level. Max 50 characters.                          |
| `severities[].description`  | string | Human-readable description. Max 150 characters.                                 |
| `severities[].icon`         | string | Approved Lucide icon key (e.g. `alert-triangle`).                               |
| `severities[].defaultColor` | string | Hex color used for display on the status dashboard.                             |
| `severities[].order`        | number | 1-based display order, unique and contiguous from 1 through the severity count. |
| `limits.severityLevels`     | number | Organization limit for max severity levels.                                     |

***

## Error responses
| Status | When                      |
| ------ | ------------------------- |
| `403`  | Insufficient permissions. |