# Get on-call schedule

Returns a single on-call schedule by ID.

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

[[path_param]]
name = "schedule_id"
description = "The ID of the on-call schedule you want to get. Use `default` if you want to get the default on-call schedule for the team."
required = true
type = "string"

[[query_param]]
name = "date"
description = "Include an ISO-8601-formatted date or date-time if you want to look-up on-call at a specific date or time."
required = false
type = "String"

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

[responses]
[[response]]
status = 200
description = '''Returns a single on-call schedule'''
body = '''{
  "data": {
    "id": "12345",
    "type": "on_call_calendar",
    "attributes": {
      "name": null,
      "default_calendar": true,
      "team_name": "Production"
    },
    "relationships": {
      "on_call_users": {
        "data": [
          {
            "id": "2345",
            "type": "user",
            "meta": { 
              "email": "tomas@uptime.betterstack.com"
            }
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "2345",
      "type": "user",
      "attributes": {
        "first_name": "Tomas",
        "last_name": "Hromada",
        "email": "tomas@uptime.betterstack.com",
        "phone_numbers": [
          "+420737123456"
        ]
      }
    }
  ]
}'''
[/responses]


#### Example cURL 

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

[info]
#### Looking for the details of a specific parameter?
Explore [the list of all on-call schedule API parameters](https://betterstack.com/docs/uptime/api/on-call-calendar-api-response-params/)
[/info]