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
      7. Severity groups
        1. List severity groups GET
        2. Get severity group GET
        3. List severities in group GET
        4. Create severity group POST
        5. Update severity group PATCH
        6. Remove severity group DELETE
        7. Response attributes
      8. Incidents
      9. Comments
    5. Status pages
    6. Metadata
    7. Integrations

List severity groups

Returns a list of all your severity groups. This endpoint supports pagination.

GET https://uptime.betterstack.com/api/v2/urgency-groups

Headers

Authorization
required string

Bearer $TOKEN

200

Returns list of existing severity groups

Response body

{
  "data": [
    {
      "id": "95251342",
      "type": "urgency_group",
      "attributes": {
        "name": "Example",
        "sort_index": null,
        "created_at": "2020-10-03T20:20:43.547Z",
        "updated_at": "2020-10-03T20:20:43.547Z",
        "team_name": "Testing"
      }
    }
  ],
  "pagination": {
    "first": "https://uptime.betterstack.com/api/v2/urgency-groups?page=1",
    "last": "https://uptime.betterstack.com/api/v2/urgency-groups?page=1",
    "prev": null,
    "next": null
  }
}

Example cURL

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


Previous article

Response attributes

Next article

Get severity group