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

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

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

Returns a list of the monitoring evaluation results and predictor events collected by the monitor resource during different windows of time.

For information about monitoring see predictor-monitoring. For more information about retrieving monitoring results see [Viewing Monitoring Results](https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring-results.html).

## Query parameters

- `MaxResults` string
- `NextToken` string

## Headers

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

## Request body

- ListMonitorEvaluationsRequest
  - `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 monitoring results to return.
  - `MonitorArn` string, required — The Amazon Resource Name (ARN) of the monitor resource to get results from.
  - `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>EvaluationState</code>.</p> </li> <li> <p> <code>Value</code> - The value to match. Valid values are only <code>SUCCESS</code> or <code>FAILURE</code>.</p> </li> </ul> <p>For example, to list only successful monitor evaluations, you would specify:</p> <p> <code>"Filters": [ { "Condition": "IS", "Key": "EvaluationState", "Value": "SUCCESS" } ]</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

- ListMonitorEvaluationsResponse
  - `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. Tokens expire after 24 hours.
  - `PredictorMonitorEvaluations` PredictorMonitorEvaluation[] — <p>The monitoring results and predictor events collected by the monitor resource during different windows of time.</p> <p>For information about monitoring see <a href="https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring-results.html">Viewing Monitoring Results</a>. For more information about retrieving monitoring results see <a href="https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring-results.html">Viewing Monitoring Results</a>.</p>
    - `ResourceArn` string — The Amazon Resource Name (ARN) of the resource to monitor.
    - `MonitorArn` string — The Amazon Resource Name (ARN) of the monitor resource.
    - `EvaluationTime` string, date-time — The timestamp that indicates when the monitor evaluation was started.
    - `EvaluationState` string — The status of the monitor evaluation. The state can be <code>SUCCESS</code> or <code>FAILURE</code>.
    - `WindowStartDatetime` string, date-time — The timestamp that indicates the start of the window that is used for monitor evaluation.
    - `WindowEndDatetime` string, date-time — The timestamp that indicates the end of the window that is used for monitor evaluation.
    - `PredictorEvent` object — Provides details about a predictor event, such as a retraining.
      - `Detail` string — The type of event. For example, <code>Retrain</code>. A retraining event denotes the timepoint when a predictor was retrained. Any monitor results from before the <code>Datetime</code> are from the previous predictor. Any new metrics are for the newly retrained predictor.
      - `Datetime` string, date-time — The timestamp for when the event occurred.
    - `MonitorDataSource` object — The source of the data the monitor resource used during the evaluation.
      - `DatasetImportJobArn` string — The Amazon Resource Name (ARN) of the dataset import job used to import the data that initiated the monitor evaluation.
      - `ForecastArn` string — The Amazon Resource Name (ARN) of the forecast the monitor used during the evaluation.
      - `PredictorArn` string — The Amazon Resource Name (ARN) of the predictor resource you are monitoring.
    - `MetricResults` MetricResult[] — A list of metrics Forecast calculated when monitoring a predictor. You can compare the value for each metric in the list to the metric's value in the <a>Baseline</a> to see how your predictor's performance is changing.
      - `MetricName` string — The name of the metric.
      - `MetricValue` number, double — The value for the metric.
    - `NumItemsEvaluated` integer — The number of items considered during the evaluation.
    - `Message` string — Information about any errors that may have occurred during the monitor evaluation.

## Other responses

- `480` — InvalidNextTokenException
- `481` — InvalidInputException
- `482` — ResourceNotFoundException

---

[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)