# ListNotificationRules


Returns a list of the notification rules for an AWS account.

## Request Syntax


```
POST /listNotificationRules HTTP/1.1
Content-type: application/json

{
   "Filters": [ 
      { 
         "Name": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## URI Request Parameters


The request does not use any URI parameters.

## Request Body


The request accepts the following data in JSON format.

 ** [Filters](#API_ListNotificationRules_RequestSyntax) **   <a name="codestarnotifications-ListNotificationRules-request-Filters"></a>
The filters to use to return information by service or resource type. For valid values, see [ListNotificationRulesFilter](API_ListNotificationRulesFilter.md).  
A filter with the same name can appear more than once when used with OR statements. Filters with different names should be applied with AND statements.
Type: Array of [ListNotificationRulesFilter](API_ListNotificationRulesFilter.md) objects  
Required: No

 ** [MaxResults](#API_ListNotificationRules_RequestSyntax) **   <a name="codestarnotifications-ListNotificationRules-request-MaxResults"></a>
A non-negative integer used to limit the number of returned results. The maximum number of results that can be returned is 100.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_ListNotificationRules_RequestSyntax) **   <a name="codestarnotifications-ListNotificationRules-request-NextToken"></a>
An enumeration token that, when provided in a request, returns the next batch of the results.  
Type: String  
Pattern: `^[\w/+=]+$`   
Required: No

## Response Syntax


```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "NotificationRules": [ 
      { 
         "Arn": "string",
         "Id": "string"
      }
   ]
}
```

## Response Elements


If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_ListNotificationRules_ResponseSyntax) **   <a name="codestarnotifications-ListNotificationRules-response-NextToken"></a>
An enumeration token that can be used in a request to return the next batch of the results.  
Type: String  
Pattern: `^[\w/+=]+$` 

 ** [NotificationRules](#API_ListNotificationRules_ResponseSyntax) **   <a name="codestarnotifications-ListNotificationRules-response-NotificationRules"></a>
The list of notification rules for the AWS account, by Amazon Resource Name (ARN) and ID.   
Type: Array of [NotificationRuleSummary](API_NotificationRuleSummary.md) objects

## Errors


For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidNextTokenException **   
The value for the enumeration token used in the request to return the next batch of the results is not valid.   
HTTP Status Code: 400

 ** ValidationException **   
One or more parameter values are not valid.  
HTTP Status Code: 400

## See Also


For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/codestar-notifications-2019-10-15/ListNotificationRules) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/codestar-notifications-2019-10-15/ListNotificationRules) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/codestar-notifications-2019-10-15/ListNotificationRules) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/codestar-notifications-2019-10-15/ListNotificationRules) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/codestar-notifications-2019-10-15/ListNotificationRules) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/codestar-notifications-2019-10-15/ListNotificationRules) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/codestar-notifications-2019-10-15/ListNotificationRules) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/codestar-notifications-2019-10-15/ListNotificationRules) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/codestar-notifications-2019-10-15/ListNotificationRules) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/codestar-notifications-2019-10-15/ListNotificationRules)