GET
https://uptime.betterstack.com/api/v2/policies
Headers
Authorization
required
string
Bearer $TOKEN
Returns a list of existing escalation policies. This endpoint supports pagination.
Headers
Bearer $TOKEN
Paginated list of escalation policies
Response body
{
"data": [
{
"id": "123",
"type": "policy",
"attributes": {
"name": "Policy - Branching",
"repeat_count": 3,
"repeat_delay": 60,
"incident_token": "vZpYuaRYvLa6t2yqRqHTmEVKu",
"policy_group_id": null,
"team_name": "Test team",
"steps": [
{
"type": "time_branching",
"wait_before": 0,
"timezone": "Prague",
"days": ["mon", "tue", "wed", "thu", "fri"],
"time_from": "00:00",
"time_to": "00:00",
"policy_id": 456
},
{
"type": "time_branching",
"wait_before": 0,
"timezone": "Prague",
"days": ["sat", "sun"],
"time_from": "00:00",
"time_to": "00:00",
"policy_id": 457
}
]
}
},
{
"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" }
]
}
]
}
}
],
"pagination": {
"first": "https://uptime.betterstack.com/api/v2/policies?page=1",
"last": "https://uptime.betterstack.com/api/v2/policies?page=1",
"prev": null,
"next": null
}
}
curl --request GET \
--url https://uptime.betterstack.com/api/v2/policies \
--header "Authorization: Bearer $TOKEN"