--- title: "List incident notification rules" method: GET path: "/api/v2/incidents/config/notification-rules" tags: ["Incidents"] --- # List incident notification rules `GET /api/v2/incidents/config/notification-rules` ## Request - Base URL: `https://api.datadoghq.com` - URL: `https://api.datadoghq.com/api/v2/incidents/config/notification-rules` - 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` Lists all notification rules for the organization. Optionally filter by incident type. ## Query parameters - `include` string ## Response `200` OK - IncidentNotificationRuleArray: Response with notification rules. - `data` IncidentNotificationRuleResponseData[], required: The `NotificationRuleArray` `data`. - `attributes` IncidentNotificationRuleAttributes: The notification rule's attributes. - `conditions` IncidentNotificationRuleConditionsItems[], required: The conditions that trigger this notification rule. - `field` string, required: The incident field to evaluate - `values` string[], required: The value(s) to compare against. Multiple values are `ORed` together. - `created` string, date-time, required: Timestamp when the notification rule was created. - `enabled` boolean, required: Whether the notification rule is enabled. - `handles` string[], required: The notification handles (targets) for this rule. - `modified` string, date-time, required: Timestamp when the notification rule was last modified. - `renotify_on` string[]: List of incident fields that trigger re-notification when changed. - `trigger` string, required: The trigger event for this notification rule. - `visibility` 'all' | 'organization' | 'private', required: The visibility of the notification rule. - `id` string, uuid, required: The unique identifier of the notification rule. - `relationships` IncidentNotificationRuleRelationships: The notification rule's resource relationships. - `created_by_user` RelationshipToUser: Relationship to user. - `data` RelationshipToUserData, required: Relationship to user object. - `id` string, required: A unique identifier that represents the user. - `type` 'users', required: Users resource type. - `incident_type` RelationshipToIncidentType: Relationship to an incident type. - `data` RelationshipToIncidentTypeData, required: Relationship to incident type object. - `id` string, required: The incident type's ID. - `type` 'incident_types', required: Incident type resource type. - `last_modified_by_user` RelationshipToUser: Relationship to user. - `data` RelationshipToUserData, required: Relationship to user object. - `id` string, required: A unique identifier that represents the user. - `type` 'users', required: Users resource type. - `notification_template` RelationshipToIncidentNotificationTemplate: A relationship reference to a notification template. - `data` RelationshipToIncidentNotificationTemplateData, required: The notification template relationship data. - `id` string, uuid, required: The unique identifier of the notification template. - `type` 'notification_templates', required: Notification templates resource type. - `type` 'incident_notification_rules', required: Notification rules resource type. - `included` IncidentNotificationRuleIncludedItems[]: Related objects that are included in the response. - union: Objects related to a notification rule. - User: User object returned by the API. - `attributes` UserAttributes: Attributes of user object returned by the API. - `created_at` string, date-time: The ISO 8601 timestamp of when the user account was created. - `disabled` boolean: Whether the user account is deactivated. Disabled users cannot log in. - `email` string: The email address of the user, used for login and notifications. - `handle` string: The unique handle (username) of the user, typically matching their email prefix. - `icon` string: URL of the user's profile icon, typically a Gravatar URL derived from the email address. - `last_login_time` string, date-time, nullable: The ISO 8601 timestamp of the user's most recent login, or null if the user has never logged in. - `mfa_enabled` boolean: Whether multi-factor authentication (MFA) is enabled for the user's account. - `modified_at` string, date-time: The ISO 8601 timestamp of when the user account was last modified. - `name` string, nullable: The full display name of the user as shown in the Datadog UI. - `service_account` boolean: Whether this is a service account rather than a human user. Service accounts are used for programmatic API access. - `status` string: The current status of the user account (for example, `Active`, `Pending`, or `Disabled`). - `title` string, nullable: The job title of the user (for example, "Senior Engineer" or "Product Manager"). - `uuid` string: The globally unique identifier (UUID) of the user. - `verified` boolean: Whether the user's email address has been verified. - `id` string: ID of the user. - `relationships` UserResponseRelationships: Relationships of the user object returned by the API. - `org` RelationshipToOrganization: Relationship to an organization. - `data` RelationshipToOrganizationData, required: Relationship to organization object. - … - `other_orgs` RelationshipToOrganizations: Relationship to organizations. - `data` RelationshipToOrganizationData[], required: Relationships to organization objects. - … - `other_users` RelationshipToUsers: Relationship to users. - `data` RelationshipToUserData[], required: Relationships to user objects. - … - `roles` RelationshipToRoles: Relationship to roles. - `data` RelationshipToRoleData[]: An array containing type and the unique identifier of a role. - … - `type` 'users': Users resource type. - IncidentTypeObject: Incident type response data. - `attributes` IncidentTypeAttributes: Incident type's attributes. - `configuration` IncidentTypeConfiguration: The incident-type-scoped behavior settings. All fields are optional on update. Any field omitted from a PATCH request keeps its current value. This object is read-only on the incident type resource itself and is only mutated through the update (PATCH) endpoint. - `allow_incident_deletion` boolean: Whether incidents of this type can be deleted. - `allow_workflows` boolean: Whether automation workflows can be triggered for incidents of this type. - `create_message` string: An optional message shown to users when they declare an incident of this type. - `editable_timestamps` boolean: Whether responders can edit incident timestamps for incidents of this type. - `private_incidents` boolean: Whether responders can create private incidents of this type. This is an opt-in setting, distinct from `private_incidents_by_default`, which controls whether incidents are created private automatically. - `private_incidents_by_default` boolean: Whether incidents of this type are created as private by default. - `slug_source` 'default' | 'servicenow': When set to `servicenow`, incidents will display the ServiceNow record ID instead of the public ID. If no ServiceNow integration exists, the public ID will be displayed. - `test_incidents` boolean: Whether incidents of this type are treated as test incidents. - `createdAt` string, date-time: Timestamp when the incident type was created. - `createdBy` string: A unique identifier that represents the user that created the incident type. - `description` string: Text that describes the incident type. - `is_default` boolean: If true, this incident type will be used as the default incident type if a type is not specified during the creation of incident resources. - `lastModifiedBy` string: A unique identifier that represents the user that last modified the incident type. - `modifiedAt` string, date-time: Timestamp when the incident type was last modified. - `name` string, required: The name of the incident type. - `prefix` string: The string that will be prepended to the incident title across the Datadog app. - `id` string, required: The incident type's ID. - `relationships` IncidentTypeRelationships: The incident type's resource relationships. - `created_by_user` RelationshipToUser: Relationship to user. - `data` RelationshipToUserData, required: Relationship to user object. - … - `google_meet_configuration` GoogleMeetConfigurationReference, nullable: A reference to a Google Meet Configuration resource. - `data` GoogleMeetConfigurationReferenceData, nullable, required: The Google Meet configuration relationship data object. - … - `last_modified_by_user` RelationshipToUser: Relationship to user. - `data` RelationshipToUserData, required: Relationship to user object. - … - `microsoft_teams_configuration` MicrosoftTeamsConfigurationReference, nullable: A reference to a Microsoft Teams Configuration resource. - `data` MicrosoftTeamsConfigurationReferenceData, nullable, required: The Microsoft Teams configuration relationship data object. - … - `zoom_configuration` ZoomConfigurationReference, nullable: A reference to a Zoom configuration resource. - `data` ZoomConfigurationReferenceData, nullable, required: The Zoom configuration relationship data object. - … - `type` 'incident_types', required: Incident type resource type. - IncidentNotificationTemplateObject: A notification template object for inclusion in other resources. - `attributes` IncidentNotificationTemplateAttributes: The notification template's attributes. - `category` string, required: The category of the notification template. - `content` string, required: The content body of the notification template. - `created` string, date-time, required: Timestamp when the notification template was created. - `modified` string, date-time, required: Timestamp when the notification template was last modified. - `name` string, required: The name of the notification template. - `subject` string, required: The subject line of the notification template. - `id` string, uuid, required: The unique identifier of the notification template. - `relationships` IncidentNotificationTemplateRelationships: The notification template's resource relationships. - `created_by_user` RelationshipToUser: Relationship to user. - `data` RelationshipToUserData, required: Relationship to user object. - … - `incident_type` RelationshipToIncidentType: Relationship to an incident type. - `data` RelationshipToIncidentTypeData, required: Relationship to incident type object. - … - `last_modified_by_user` RelationshipToUser: Relationship to user. - `data` RelationshipToUserData, required: Relationship to user object. - … - `type` 'notification_templates', required: Notification templates resource type. - `meta` IncidentNotificationRuleArrayMeta: Response metadata. - `pagination` IncidentNotificationRuleArrayMetaPage: Pagination metadata. - `next_offset` integer: The offset for the next page of results. - `offset` integer: The current offset in the results. - `size` integer: The number of results returned per page. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `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/da68bf029e4c?raw)