provider On-Call GET /api/v2/on-call/schedules/{schedule_id}/on-call
@utdk/datadog /api/v2/on-call/schedules/{schedule_id}/on-call
Get scheduled on-call user
Retrieves the user who is on-call for the specified schedule at a given time.
include query
Specifies related resources to include in the response as a comma-separated list. Allowed value: `user`.
string
schedule_id path required
The ID of the schedule.
string
filter[at_ts] query
Retrieves the on-call user at the given timestamp in RFC3339 format (for example, `2025-05-07T02:53:01Z` or `2025-05-07T02:53:01+00:00`). When using timezone offsets with `+` or `-`, ensure proper URL encoding (`+` should be encoded as `%2B`). Defaults to the current time if omitted.
string

Try it

Authentication
Configure credentials for Datadog API V2 Collection
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.

Saved automatically to browser storage.

getscheduleoncalluser
GET/api/v2/on-call/schedules/{schedule_id}/on-call
Retrieves the user who is on-call for the specified schedule at a given time.

Parameters

required

The ID of the schedule.

Specifies related resources to include in the response as a comma-separated list. Allowed value: `user`.

Retrieves the on-call user at the given timestamp in RFC3339 format (for example, `2025-05-07T02:53:01Z` or `2025-05-07T02:53:01+00:00`). When using timezone offsets with `+` or `-`, ensure proper URL encoding (`+` should be encoded as `%2B`). Defaults to the current time if omitted.

Enter a gateway URL above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import datadog from '@utdk/datadog';

await datadog.getscheduleoncalluser()