Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Advanced guide
    3. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Uptime API
    1. Getting an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
      1. On-call schedule
      2. On-call schedule events
      3. On-call schedule rotations
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
        1. List severities GET
        2. Get severity GET
        3. Create severity POST
        4. Update severity PATCH
        5. Remove severity DELETE
        6. Response attributes
      7. Severity groups
      8. Incidents
      9. Comments
    5. Status pages
    6. Metadata
    7. Integrations

List severities

Returns a list of existing severities. This endpoint supports pagination.

GET https://uptime.betterstack.com/api/v2/urgencies

Query parameters

team_name
string

Filter severities belonging to a specified team when using global API token.

Headers

Authorization
required string

Bearer $TOKEN

200

Paginated list of severities

Response body

{
  "data": [
    {
      "id": "123",
      "type": "urgency",
      "attributes": {
        "name": "High Severity",
        "team_name": "Test team",
        "sms": false,
        "call": true,
        "email": true,
        "push": true
      }
    },
    {
      "id": "456",
      "type": "urgency",
      "attributes": {
        "name": "Low Severity",
        "team_name": "Test team",
        "sms": false,
        "call": false,
        "email": true,
        "push": false
      }
    }
  ],
  "pagination": {
    "first": "https://uptime.betterstack.com/api/v2/urgencies?page=1",
    "last": "https://uptime.betterstack.com/api/v2/urgencies?page=1",
    "prev": null,
    "next": null
  }
}

Example cURL

Example
curl --request GET \
  --url https://uptime.betterstack.com/api/v2/urgencies \
  --header "Authorization: Bearer $TOKEN"


Previous article

Response attributes

Next article

Get severity