Explore documentation

List on-call calendar events

List events of a single on-call calendar. This endpoint does not support pagination and returns all events instead.

GET https://uptime.betterstack.com/api/v2/on-calls/{calendar_id}/events

URL parameters

calendar_id
required string

Headers

Authorization
required string
200

Response body

{
  "events": [
    {
      "id": 12345,
      "users": ["tomas@betterstack.com"],
      "starts_at": "2024-09-04T22:00:00Z",
      "ends_at": "2024-09-05T22:00:00Z",
    },
    {
      "id": 23456,
      "users": ["simon@betterstack.com"],
      "starts_at": "2024-09-05T22:00:00Z",
      "ends_at": "2024-09-06T22:00:00Z",
    },
    {
      "id": 34567,
      "users": ["tomas@betterstack.com"],
      "starts_at": "2024-09-06T22:00:00Z",
      "ends_at": "2024-09-07T22:00:00Z",
    }
  ]
}

Example cURL

Example
curl --request GET \
  --url "https://uptime.betterstack.com/api/v2/on-calls/default/events" \
  --header "Authorization: Bearer $TOKEN"