Explore documentation

Get a single escalation policy

Returns a single escalation policy by ID.

GET https://uptime.betterstack.com/api/v2/policies/{policy_id}

URL parameters

policy_id
required string

Headers

Authorization
required string
200

Response body

{
  "data": {
    "id": "456",
    "type": "policy",
    "attributes": {
      "name": "Policy A",
      "repeat_count": 5,
      "repeat_delay": 0,
      "incident_token": "8nEiLj2gfqjfQRK6vzkFuGC25",
      "policy_group_id": null,
      "team_name": "Test team"
    },
    "steps": [
      {
        "type": "escalation",
        "wait_before": 0,
        "urgency_id": 12345,
        "step_members": [
          {
            "type": "all_slack_integrations"
          },
          {
            "type": "current_on_call"
          }
        ]
      }
    ]
  }
}
404

Response body

{
  "errors": "Resource with provided ID was not found"
}

Example cURL

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