> For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

# atlas alerts list

Return all alerts for your project.

To use this command, you must authenticate with a user account, a service account, or an API key with the Project Read Only role.

## Syntax

```text
atlas alerts list [options]
```

## Options

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| -h, --help |  | false | help for list |
| --limit | int | false | Number of items per results page, up to a maximum of 500. If you have more than 500 results, specify the --page option to change the results page. This value defaults to 100. |
| --omitCount |  | false | Flag that indicates whether the JSON response returns the total number of items (totalCount) in the JSON response. |
| -o, --output | string | false | Output format. Valid values are json, json-path, go-template, or go-template-file. To see the full output, use the -o json option. |
| --page | int | false | Page number that specifies a page of results. This value defaults to 1. |
| --projectId | string | false | Hexadecimal string that identifies the project to use. This option overrides the settings in the configuration file or environment variable. |
| --status | string | false | State of the alert. Valid values include TRACKING, OPEN, CLOSED, and CANCELLED. |

## Inherited Options

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| -P, --profile | string | false | Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see [https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.](https://dochub.mongodb.org/core/atlas-cli-save-connection-settings) |

## Output

If the command succeeds, the CLI returns output similar to the following sample. Values in brackets represent your values.

```text
ID     TYPE              STATUS
<Id>   <EventTypeName>   <Status>
```

## Examples

```text
# Return a JSON-formatted list of all alerts for the project with the ID 5e2211c17a3e5a48f5497de3:
atlas alerts list --projectId 5e2211c17a3e5a48f5497de3 --output json
```