List On-Call schedule overrides
https://api.datadoghq.com/api/v2/on-call/schedules/{schedule_id}/overrideshttps://api.us3.datadoghq.com/api/v2/on-call/schedules/{schedule_id}/overrideshttps://api.us5.datadoghq.com/api/v2/on-call/schedules/{schedule_id}/overrideshttps://api.datadoghq.eu/api/v2/on-call/schedules/{schedule_id}/overrideshttps://api.ap1.datadoghq.com/api/v2/on-call/schedules/{schedule_id}/overrideshttps://api.ap2.datadoghq.com/api/v2/on-call/schedules/{schedule_id}/overrideshttps://api.uk1.datadoghq.com/api/v2/on-call/schedules/{schedule_id}/overrideshttps://api.ddog-gov.com/api/v2/on-call/schedules/{schedule_id}/overrideshttps://api.us2.ddog-gov.com/api/v2/on-call/schedules/{schedule_id}/overridesOverview
Retrieve a list of overrides for the specified On-Call schedule within a given time range.
Arguments
Path Parameters
schedule_id [required]The ID of the schedule.
Query Strings
filter[start] [required]Start of the time range to retrieve overrides for, in RFC3339 format (for example, 2025-05-07T02:53:01Z or 2025-05-07T02:53:01+00:00). If you use a time zone offset with +, URL-encode the + as %2B.
filter[end] [required]End of the time range to retrieve overrides for, in RFC3339 format (for example, 2025-05-07T02:53:01Z or 2025-05-07T02:53:01+00:00). If you use a time zone offset with +, URL-encode the + as %2B. The time range cannot exceed 45 days.
includeComma-separated list of related resources to include in the response. Allowed values: user, overridden_user, user.color.
page[size]Number of overrides to return per page. The maximum allowed value is 50.
10page[number]Specific page number to return.
0Response
OK
A list of on-call schedule overrides and any related included resources (such as users).
data [required]A list of on-call schedule overrides.
attributesAttributes for an on-call schedule override.
endThe end time of the override.
inactiveWhether the override is inactive (for example, because its time range has ended).
startThe start time of the override.
id [required]The unique identifier of the override.
relationshipsRelationships for an on-call schedule override.
overridden_userDefines the relationship between an override and one of its associated users.
data [required]A reference to a user, containing the user's ID and resource type.
id [required]The unique identifier of the user.
type [required]Indicates that the related resource is of type 'users'.
usersusersscheduleDefines the relationship between an override and the schedule it belongs to.
data [required]A reference to the schedule the override belongs to, containing the schedule's ID and resource type.
id [required]The unique identifier of the schedule.
type [required]Indicates that the related resource is of type 'schedules'.
schedulesschedulesuserDefines the relationship between an override and one of its associated users.
data [required]A reference to a user, containing the user's ID and resource type.
id [required]The unique identifier of the user.
type [required]Indicates that the related resource is of type 'users'.
usersuserstype [required]Indicates that the resource is of type 'overrides'.
overridesoverridesincludedRelated resources referenced in the overrides' relationships, such as users.
<type=users>Represents a user object in the context of a schedule, including their id, type, and basic attributes.
attributesProvides basic user information for a schedule, including a name and email address.
colorThe user's on-call color, as a hex code (for example, #FF0000). Included only when user.color is requested in the include parameter.
emailThe user's email address.
nameThe user's name.
statusThe user's status.
active, deactivated, pendingid [required]The unique user identifier.
type [required]Users resource type.
usersusers{
"data": [
{
"attributes": {
"end": "2024-01-08T02:53:01.000000000Z",
"inactive": false,
"start": "2024-01-07T02:53:01.000000000Z"
},
"id": "00000000-0000-0000-0000-000000000000",
"relationships": {
"schedule": {
"data": {
"id": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
"type": "schedules"
}
},
"user": {
"data": {
"id": "00000000-aba1-0000-0000-000000000000",
"type": "users"
}
}
},
"type": "overrides"
}
],
"included": [
{
"attributes": {
"email": "jane.doe@example.com",
"name": "Jane Doe",
"status": ""
},
"id": "00000000-aba1-0000-0000-000000000000",
"type": "users"
}
]
}Bad Request
API error response.
errors [required]A list of errors.
{
"errors": [
"Bad Request"
]
}Unauthorized
API error response.
errors [required]A list of errors.
{
"errors": [
"Bad Request"
]
}Forbidden
API error response.
errors [required]A list of errors.
{
"errors": [
"Bad Request"
]
}Not Found
API error response.
errors [required]A list of errors.
{
"errors": [
"Bad Request"
]
}Too many requests
API error response.
errors [required]A list of errors.
{
"errors": [
"Bad Request"
]
}Code Example
# Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Required query arguments
export filter_start="2024-01-07T02:53:01Z"
export filter_end="2024-01-14T02:53:01Z"
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/on-call/schedules/${schedule_id}/overrides?filter%5Bstart%5D=${filter_start}&filter%5Bend%5D=${filter_end}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Required query arguments
export filter_start="2024-01-07T02:53:01Z"
export filter_end="2024-01-14T02:53:01Z"
# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/on-call/schedules/${schedule_id}/overrides?filter%5Bstart%5D=${filter_start}&filter%5Bend%5D=${filter_end}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Required query arguments
export filter_start="2024-01-07T02:53:01Z"
export filter_end="2024-01-14T02:53:01Z"
# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/on-call/schedules/${schedule_id}/overrides?filter%5Bstart%5D=${filter_start}&filter%5Bend%5D=${filter_end}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Required query arguments
export filter_start="2024-01-07T02:53:01Z"
export filter_end="2024-01-14T02:53:01Z"
# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/on-call/schedules/${schedule_id}/overrides?filter%5Bstart%5D=${filter_start}&filter%5Bend%5D=${filter_end}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Required query arguments
export filter_start="2024-01-07T02:53:01Z"
export filter_end="2024-01-14T02:53:01Z"
# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/on-call/schedules/${schedule_id}/overrides?filter%5Bstart%5D=${filter_start}&filter%5Bend%5D=${filter_end}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Required query arguments
export filter_start="2024-01-07T02:53:01Z"
export filter_end="2024-01-14T02:53:01Z"
# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/on-call/schedules/${schedule_id}/overrides?filter%5Bstart%5D=${filter_start}&filter%5Bend%5D=${filter_end}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Required query arguments
export filter_start="2024-01-07T02:53:01Z"
export filter_end="2024-01-14T02:53:01Z"
# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/on-call/schedules/${schedule_id}/overrides?filter%5Bstart%5D=${filter_start}&filter%5Bend%5D=${filter_end}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Required query arguments
export filter_start="2024-01-07T02:53:01Z"
export filter_end="2024-01-14T02:53:01Z"
# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/on-call/schedules/${schedule_id}/overrides?filter%5Bstart%5D=${filter_start}&filter%5Bend%5D=${filter_end}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"# Path parameters
export schedule_id="3653d3c6-0c75-11ea-ad28-fb5701eabc7d"
# Required query arguments
export filter_start="2024-01-07T02:53:01Z"
export filter_end="2024-01-14T02:53:01Z"
# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X GET "https://api.${DD_SITE}/api/v2/on-call/schedules/${schedule_id}/overrides?filter%5Bstart%5D=${filter_start}&filter%5Bend%5D=${filter_end}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"