--- title: "Get all monitor notification rules" method: GET path: "/api/v2/monitor/notification_rule" tags: ["Monitors"] --- # Get all monitor notification rules `GET /api/v2/monitor/notification_rule` ## Request - Base URL: `https://api.datadoghq.com` - URL: `https://api.datadoghq.com/api/v2/monitor/notification_rule` - 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` scopes: `monitors_read` Returns a list of all monitor notification rules. ## Query parameters - `page` integer - `per_page` integer - `sort` string - `filters` string - `include` string ## Response `200` OK - MonitorNotificationRuleListResponse: Response for retrieving all monitor notification rules. - `data` MonitorNotificationRuleData[]: A list of monitor notification rules. - `attributes` MonitorNotificationRuleResponseAttributes: Attributes of the monitor notification rule. - `conditional_recipients` MonitorNotificationRuleConditionalRecipients: Use conditional recipients to define different recipients for different situations. Cannot be used with `recipients`. - `conditions` MonitorNotificationRuleCondition[], required: Conditions of the notification rule. - `recipients` string[], required: A list of recipients to notify. Uses the same format as the monitor `message` field. Must not start with an '@'. Cannot be used with `conditional_recipients`. - `scope` string, required: Defines the condition under which the recipients are notified. Supported formats: - Monitor status condition using `transition_type:`, for example `transition_type:is_alert`. - A single tag key:value pair, for example `env:prod`. - `fallback_recipients` string[]: A list of recipients to notify. Uses the same format as the monitor `message` field. Must not start with an '@'. Cannot be used with `conditional_recipients`. - `created` string, date-time: Creation time of the monitor notification rule. - `filter` union: Specifies the matching criteria for monitor notifications. - MonitorNotificationRuleFilterTags: Filters monitor notifications by a list of tag key:value pairs. - `tags` string[], required: A list of tag key:value pairs (e.g. `team:product`). All tags must match (AND semantics). - MonitorNotificationRuleFilterScope: Filters monitor notifications using a scope expression over key:value pairs with boolean logic (AND, OR, NOT). - `scope` string, required: A scope expression composed by key:value pairs (e.g. `service:foo`) with boolean operators (AND, OR, NOT) and parentheses for grouping. - `modified` string, date-time: Time the monitor notification rule was last modified. - `name` string: The name of the monitor notification rule. - `recipients` string[]: A list of recipients to notify. Uses the same format as the monitor `message` field. Must not start with an '@'. Cannot be used with `conditional_recipients`. - `id` string: The ID of the monitor notification rule. - `relationships` MonitorNotificationRuleRelationships: All relationships associated with monitor notification rule. - `created_by` MonitorNotificationRuleRelationshipsCreatedBy: The user who created the monitor notification rule. - `data` MonitorNotificationRuleRelationshipsCreatedByData, nullable: Data for the user who created the monitor notification rule. - `id` string: User ID of the monitor notification rule creator. - `type` 'users': Users resource type. - `type` 'monitor-notification-rule': Monitor notification rule resource type. - `included` MonitorNotificationRuleResponseIncludedItem[]: Array of objects related to the monitor notification rules. - `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. - `id` string, required: ID of the organization. - `type` 'orgs', required: Organizations resource type. - `other_orgs` RelationshipToOrganizations: Relationship to organizations. - `data` RelationshipToOrganizationData[], required: Relationships to organization objects. - `id` string, required: ID of the organization. - `type` 'orgs', required: Organizations resource type. - `other_users` RelationshipToUsers: Relationship to users. - `data` RelationshipToUserData[], required: Relationships to user objects. - `id` string, required: A unique identifier that represents the user. - `type` 'users', required: Users resource type. - `roles` RelationshipToRoles: Relationship to roles. - `data` RelationshipToRoleData[]: An array containing type and the unique identifier of a role. - `id` string: The unique identifier of the role. - `type` 'roles': Roles type. - `type` 'users': Users resource type. ## Other responses - `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/da68bf029e4c?raw)