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 schedule
      2. On-call schedule events
        1. List on-call schedule events GET
        2. Get on-call schedule event GET
        3. Create on-call schedule event POST
        4. Update on-cal schedule event PATCH
        5. Remove on-call schedule event DELETE
        6. Bulk update on-call schedule events PUT
        7. Response attributes
      3. On-call schedule rotations
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
      7. Severity groups
      8. Incidents
      9. Comments
    5. Status pages
    6. Metadata
    7. Integrations

Get a single on-call schedule event

Get a single event from an on-call schedule.

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

URL parameters

schedule_id
required string

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

event_id
required string

The ID of the event to return.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a single event.

Response body

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

Example cURL

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

Previous article

List on-call schedule events

Next article

Create an on-call schedule event