---
title: "Evaluation History"
method: POST
path: "/v1/monitors/evaluation-history/{monitorId}"
tags: ["Monitors"]
---

# Evaluation History

`POST /v1/monitors/evaluation-history/{monitorId}`

Get historical evaluations of the monitor ordered by evaluation creation time descending. By default this will return pages of 500 evaluations. To page through all data, specify the `createdAt` request to get the next chunk of data. Even though this is a post request, no data is mutated.

## Path parameters

- `monitorId` string, uuid, required

## Request body

- EvaluationHistoryRequest
  - `groupings` LabelNameValue[], nullable — Optional, only needed if you want the history for a specific group of a group by monitor
    - `name` string
    - `value` string
  - `createdAt` string, date-time, nullable — Leaving empty gets starts at the most recent evaluation
  - `sortOrder` 'ASC' | 'DESC'
  - `limit` integer, nullable — How many records to return. Max number per page is 500

## Response `200`

Success

- MonitorStatus[]
  - `result` number, double, nullable
  - `lowerBound` number, double, nullable
  - `upperBound` number, double, nullable
  - `predicted` number, double, nullable
  - `passed` boolean, nullable
  - `createdAt` string, date-time
  - `status` 'PASS' | 'FAIL' | 'IN_TRAINING' | 'FAILED_TO_PREDICT' | 'NOT_ENOUGH_DATA' | 'ERROR' | 'INVALID_INPUT', nullable
  - `openRelatedIncidents` integer[] — A list of currently active incidents
  - `errorMessage` string, nullable — Error message if the latest evaluation is failed
  - `annotation` AnnotatedPoint, nullable — Optional annotation that was applied to this specific datapoint
    - `annotationType` 'FALSE_POSITIVE' | 'FALSE_NEGATIVE' | 'EXPECTED_OCCASIONALLY' | 'NEW_BASELINE' | 'TRUE_POSITIVE'
    - `annotatedTimestamp` string, date-time
    - `annotatingUserEmail` string

---

[API](https://skmtc.dev/metaplane/apis/metaplane-api.md) · [All operations](https://skmtc.dev/metaplane/apis/metaplane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/metaplane/metaplane-api/revisions/97bbb4440547/schema)