--- title: "List On-Call escalation policies" method: GET path: "/api/v2/on-call/escalation-policies" tags: ["On-Call"] --- # List On-Call escalation policies `GET /api/v2/on-call/escalation-policies` ## Request - Base URL: `https://api.datadoghq.com` - URL: `https://api.datadoghq.com/api/v2/on-call/escalation-policies` - Auth: one of: - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY` - OAuth 2 - Authorization code: `/oauth2/v1/authorize` - Token URL: `/oauth2/v1/token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve a paginated list of On-Call escalation policies, sorted by name. ## Query parameters - `page[size]` integer - `page[number]` integer - `filter[query]` string - `filter[team_id]` string - `filter[user_id]` string - `filter[schedule_id]` string - `filter[tags]` string - `filter[tags_any]` string - `include` string ## Response `200` OK - EscalationPolicies: A paginated list of escalation policies, with any related resources requested through `include`. - `data` EscalationPolicyListItem[], required: A list of escalation policies. - `attributes` EscalationPolicyDataAttributes: Defines the main attributes of an escalation policy, such as its name and behavior on policy end. - `name` string, required: Specifies the name of the escalation policy. - `resolve_page_on_policy_end` boolean: Indicates whether the Page is automatically resolved when the policy ends. - `retries` integer: Specifies how many times the escalation sequence is retried if there is no response. - `tags` string[]: A list of tags attached to the escalation policy, in `key:value` format. - `id` string, required: Specifies the unique identifier of the escalation policy. - `relationships` EscalationPolicyDataRelationships: Represents the relationships for an escalation policy, including references to steps and teams. - `steps` EscalationPolicyDataRelationshipsSteps, required: Defines the relationship to a collection of steps within an escalation policy. Contains an array of step data references. - `data` EscalationPolicyDataRelationshipsStepsDataItems[]: An array of references to the steps defined in this escalation policy. - `id` string, required: Specifies the unique identifier for the step resource. - `type` 'steps', required: Indicates that the resource is of type `steps`. - `teams` DataRelationshipsTeams: Associates teams with this schedule in a data structure. - `data` DataRelationshipsTeamsDataItems[]: An array of team references for this schedule. - `id` string, required: The unique identifier of the team in this relationship. - `type` 'teams', required: Teams resource type. - `type` 'policies', required: Indicates that the resource is of type `policies`. - `included` EscalationPolicyIncluded[]: Provides any included related resources, such as teams, steps, or targets, returned with the policies. - union: Represents included related resources when retrieving an escalation policy, such as teams, steps, or targets. - EscalationPolicyStep: Represents a single step in an escalation policy, including its attributes, relationships, and resource type. - `attributes` EscalationPolicyStepAttributes: Defines attributes for an escalation policy step, such as assignment strategy and escalation timeout. - `assignment` 'default' | 'round-robin': Specifies how this escalation step will assign targets (example `default` or `round-robin`). - `escalate_after_seconds` integer: Specifies how many seconds to wait before escalating to the next step. - `id` string: Specifies the unique identifier of this escalation policy step. - `relationships` EscalationPolicyStepRelationships: Represents the relationship of an escalation policy step to its targets. - `targets` EscalationTargets: A list of escalation targets for a step - `data` EscalationTarget[]: The `EscalationTargets` `data`. - … - `type` 'steps', required: Indicates that the resource is of type `steps`. - EscalationPolicyUser: Represents a user object in the context of an escalation policy, including their `id`, type, and basic attributes. - `attributes` EscalationPolicyUserAttributes: Provides basic user information for an escalation policy, including a name and email address. - `color` string: The user's on-call color, as a hex code (for example, `#FF0000`). Included only when `user.color` is requested in the `include` parameter. - `email` string: The user's email address. - `name` string: The user's name. - `status` 'active' | 'deactivated' | 'pending': The user's status. - `id` string: The unique user identifier. - `type` 'users', required: Users resource type. - ScheduleData: Represents the primary data object for a schedule, linking attributes and relationships. - `attributes` ScheduleDataAttributes: Provides core properties of a schedule object such as its name and time zone. - `max_responders` integer: Maximum number of users who can be on call at the same time. The value is between 1 and the number of layers, and no greater than 10. - `name` string: A short name for the schedule. - `tags` string[]: A list of tags associated with the schedule. - `time_zone` string: The time zone in which this schedule operates. - `id` string: The schedule's unique identifier. - `relationships` ScheduleDataRelationships: Groups the relationships for a schedule object, referencing layers and teams. - `layers` ScheduleDataRelationshipsLayers: Associates layers with this schedule in a data structure. - `data` ScheduleDataRelationshipsLayersDataItems[]: An array of layer references for this schedule. - … - `teams` DataRelationshipsTeams: Associates teams with this schedule in a data structure. - `data` DataRelationshipsTeamsDataItems[]: An array of team references for this schedule. - … - `type` 'schedules', required: Schedules resource type. - ConfiguredSchedule: Full resource representation of a configured schedule target with position (previous, current, or next). - `attributes` ConfiguredScheduleTargetAttributes, required: Attributes for a configured schedule target, including position. - `position` 'previous' | 'current' | 'next', required: Specifies the position of a schedule target (example `previous`, `current`, or `next`). - `id` string, required: Specifies the unique identifier of the configured schedule target. - `relationships` ConfiguredScheduleTargetRelationships, required: Represents the relationships of a configured schedule target. - `schedule` ConfiguredScheduleTargetRelationshipsSchedule, required: Holds the schedule reference for a configured schedule target. - `data` ScheduleTarget, required: Represents a schedule target for an escalation policy step, including its ID and resource type. This is a shortcut for a configured schedule target with position set to 'current'. - … - `type` 'schedule_target', required: Indicates that the resource is of type `schedule_target`. - TeamReference: Provides a reference to a team, including ID, type, and basic attributes/relationships. - `attributes` TeamReferenceAttributes: Encapsulates the basic attributes of a Team reference, such as name, handle, and an optional avatar or description. - `avatar` string: URL or reference for the team's avatar (if available). - `description` string: A short text describing the team. - `handle` string: A unique handle/slug for the team. - `name` string: The full, human-readable name of the team. - `id` string: The team's unique identifier. - `type` 'teams', required: Teams resource type. - `meta` EscalationPoliciesResponseMeta: Metadata included in the response when listing escalation policies. - `page` EscalationPoliciesResponseMetaPage: Pagination metadata included in the response when listing escalation policies. - `first_number` integer: First page number. - `last_number` integer: Last page number. - `next_number` integer, nullable: Next page number. - `number` integer: Page number. - `prev_number` integer, nullable: Previous page number. - `size` integer: Page size. - `total` integer: Total number of results. - `type` string: Pagination type. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `429`: Too many requests --- [API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/3f70db624329?raw)