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

List escalation policy groups

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

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

Query parameters

team_name
string

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

Headers

Authorization
required string

Bearer $TOKEN

200

Returns list of existing escalation policy groups

Response body

{
  "data": [
    {
      "id": "95251342",
      "type": "policy_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": "Test team"
      }
    }
  ],
  "pagination": {
    "first": "https://uptime.betterstack.com/api/v2/policy-groups?page=1",
    "last": "https://uptime.betterstack.com/api/v2/policy-groups?page=1",
    "prev": null,
    "next": null
  }
}

Example cURL

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


Previous article

Response attributes

Next article

Get escalation policy group