Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. 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. Incidents 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
      6. Severities
      7. Severity groups
      8. Incidents
      9. Comments
    5. Status pages
    6. Metadata
    7. Integrations
    8. Team members
    9. Organization roles
    10. Usage
    11. Reporting

Get escalation policy group

Returns a single escalation policy group by ID.

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

URL parameters

policy_group_id
required string

The ID of the escalation policy group you want to get.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns the requested escalation policy group.

Response body

{
  "data": {
    "id": "95251342",
    "type": "policy_group",
    "attributes": {
      "name": "Log alerts",
      "sort_index": null,
      "created_at": "2024-07-26T15:07:46.350Z",
      "updated_at": "2024-07-26T15:07:46.350Z",
      "team_name": "Test team"
    }
  }
}

Response attributes

id
string

The ID of the escalation policy group.

type
string

Always policy_group.

attributes.name
string

The name of the group, as shown in the dashboard.

attributes.sort_index
integer or null

The position of the group in your list of escalation policy groups, lower values first. null when no position was set.

attributes.created_at
string

When the group was created, in ISO 8601 format.

attributes.updated_at
string

When the group was last updated, in ISO 8601 format.

attributes.team_name
string

The team the group belongs to.

Example cURL

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


Previous article

List escalation policy groups

Next article

List policies in a group