Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  4. On-call scheduling and alerting
    1. Get started
    2. Sending alerts to Slack ↗
    3. Connecting external calendars
    4. Advanced guide
  5. Incidents
    1. Get started
    2. Advanced guide
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Integrations
    1. Integrating with Better Stack
  8. Team and account management
    1. Team management
    2. Account settings
    3. Audit logs
    4. Migrating to pay as you go
  9. Uptime API
    1. Get an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
      1. On-call calendar
      2. On-call calendar events
      3. On-call calendar rotations
        1. Get on-call calendar rotation GET
        2. Create on-call calendar rotation POST
        3. Remove on-call calendar rotation DELETE
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
      7. Severity groups
      8. Incidents
      9. Comments
    5. Status pages
    6. Metadata
    7. Integrations

Get an on-call calendar rotation

Returns the currently used on-call rotation for a single on-call calendar.

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

URL parameters

calendar_id
required string

The ID of the on-call calendar you want to get events for. Use default to refer to the default on-call calendar for the team.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns an information about on-call rotation if present

Response body

{
  "rotation_length": 8,
  "rotation_interval": "hour",
  "start_rotations_at": "2025-02-01T07:00:00.000Z",
  "end_rotations_at": "2027-02-01T07:00:00.000Z",
  "users": [
    "bob@betterstack.com",
    "alice@betterstack.com"
  ]
}
404

Returns 404 when the on-call calendar doesn't have a rotation defined

Example cURL

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

Previous article

Response params

Next article

Create an on-call calendar rotation