# Get an on-call schedule rotation

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

[endpoint]
base_url = "https://uptime.betterstack.com"
path = "/api/v2/on-calls/{schedule_id}/rotation"
method = "GET"

[[path_param]]
name = "schedule_id"
description = "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."
required = true
type = "string"

[[query_param]]
name = "team_name"
description = "Required if using [global API token](https://betterstack.com/docs/uptime/api/getting-started-with-uptime-api/#get-a-global-api-token) to specify the team which owns the resource."
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"

[/endpoint]

[responses]
[[response]]
status = 200
description = '''Returns an information about on-call rotation if present'''
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"
  ]
}'''

[[response]]
status = 404
description = '''Returns 404 when the on-call schedule doesn't have a rotation defined'''

[/responses]


#### Example cURL 

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