---
title: "POST /#X-Amz-Target=AmazonForecast.ListMonitors"
method: POST
path: "/#X-Amz-Target=AmazonForecast.ListMonitors"
---

# POST /#X-Amz-Target=AmazonForecast.ListMonitors

`POST /#X-Amz-Target=AmazonForecast.ListMonitors`

Returns a list of monitors created with the <a>CreateMonitor</a> operation and <a>CreateAutoPredictor</a> operation. For each monitor resource, this operation returns of a summary of its properties, including its Amazon Resource Name (ARN). You can retrieve a complete set of properties of a monitor resource by specify the monitor's ARN in the <a>DescribeMonitor</a> operation.

## Query parameters

- `MaxResults` string
- `NextToken` string

## Headers

- `X-Amz-Target` 'AmazonForecast.ListMonitors', required

## Request body

- ListMonitorsRequest
  - `NextToken` string — If the result of the previous request was truncated, the response includes a <code>NextToken</code>. To retrieve the next set of results, use the token in the next request. Tokens expire after 24 hours.
  - `MaxResults` integer — The maximum number of monitors to include in the response.
  - `Filters` Filter[] — <p>An array of filters. For each filter, provide a condition and a match statement. The condition is either <code>IS</code> or <code>IS_NOT</code>, which specifies whether to include or exclude the resources that match the statement from the list. The match statement consists of a key and a value.</p> <p> <b>Filter properties</b> </p> <ul> <li> <p> <code>Condition</code> - The condition to apply. Valid values are <code>IS</code> and <code>IS_NOT</code>.</p> </li> <li> <p> <code>Key</code> - The name of the parameter to filter on. The only valid value is <code>Status</code>.</p> </li> <li> <p> <code>Value</code> - The value to match.</p> </li> </ul> <p>For example, to list all monitors who's status is ACTIVE, you would specify:</p> <p> <code>"Filters": [ { "Condition": "IS", "Key": "Status", "Value": "ACTIVE" } ]</code> </p>
    - `Key` string, required — The name of the parameter to filter on.
    - `Value` string, required — The value to match.
    - `Condition` 'IS' | 'IS_NOT', required — The condition to apply. To include the objects that match the statement, specify <code>IS</code>. To exclude matching objects, specify <code>IS_NOT</code>.

## Response `200`

Success

- ListMonitorsResponse
  - `Monitors` MonitorSummary[] — An array of objects that summarize each monitor's properties.
    - `MonitorArn` string — The Amazon Resource Name (ARN) of the monitor resource.
    - `MonitorName` string — The name of the monitor resource.
    - `ResourceArn` string — The Amazon Resource Name (ARN) of the predictor being monitored.
    - `Status` string — <p>The status of the monitor. States include:</p> <ul> <li> <p> <code>ACTIVE</code> </p> </li> <li> <p> <code>ACTIVE_STOPPING</code>, <code>ACTIVE_STOPPED</code> </p> </li> <li> <p> <code>UPDATE_IN_PROGRESS</code> </p> </li> <li> <p> <code>CREATE_PENDING</code>, <code>CREATE_IN_PROGRESS</code>, <code>CREATE_FAILED</code> </p> </li> <li> <p> <code>DELETE_PENDING</code>, <code>DELETE_IN_PROGRESS</code>, <code>DELETE_FAILED</code> </p> </li> </ul>
    - `CreationTime` string, date-time — When the monitor resource was created.
    - `LastModificationTime` string, date-time — <p>The last time the monitor resource was modified. The timestamp depends on the status of the job:</p> <ul> <li> <p> <code>CREATE_PENDING</code> - The <code>CreationTime</code>.</p> </li> <li> <p> <code>CREATE_IN_PROGRESS</code> - The current timestamp.</p> </li> <li> <p> <code>STOPPED</code> - When the resource stopped.</p> </li> <li> <p> <code>ACTIVE</code> or <code>CREATE_FAILED</code> - When the monitor creation finished or failed.</p> </li> </ul>
  - `NextToken` string — If the response is truncated, Amazon Forecast returns this token. To retrieve the next set of results, use the token in the next request.

## Other responses

- `480` — InvalidNextTokenException
- `481` — InvalidInputException

---

[API](https://skmtc.net/aws/apis/forecast.md) · [All operations](https://skmtc.net/aws/apis/forecast/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/forecast/versions/3d1c872d2ac9/schema)