---
title: "Get SMTP Monitor Check History"
method: GET
path: "/api/smtp-monitors/{id}/check-history"
tags: ["Smtp Monitors"]
---

# Get SMTP Monitor Check History

`GET /api/smtp-monitors/{id}/check-history`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/smtp-monitors/{id}/check-history`
- Auth: HTTP bearer

GET /api/smtp-monitors/:smtpMonitorPublicId/check-history

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `limit` integer
- `format` 'json' | 'csv'
- `download` '0' | '1'
- `from` union
  - string, date
  - string, date-time
- `to` union
  - string, date
  - string, date-time
- `status` 'success' | 'failure'
- `minMs` number
- `maxMs` number

## Response `200`

OK

- object
  - `data` object[], required
    - `id` string, required: Check id, or 1min-<instant> for a minute aggregate.
    - `status` string, required: success, failure or timeout; aggregates success or failure.
    - `success` boolean, required
    - `errorMessage` string, nullable, required
    - `checkedAt` string, date-time, required
    - `responseTimeMs` number, nullable, required
    - `location` object, nullable, required: null on minute aggregates.
      - `name` string, nullable, required
      - `code` string, nullable, required
    - `resolution` 'raw' | '1min', required: raw within the raw retention window, older rows are minute aggregates.
    - `totalLocations` integer: Minute aggregates only.
    - `failedLocations` integer: Minute aggregates only.
  - `total` integer, required
  - `page` integer, required
  - `pageCount` integer, required
  - `resolution` 'raw' | '1min' | 'mixed', required
  - `rawWindowFrom` string, date-time, required: Rows before this instant are minute aggregates.

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `404`: No such resource, or not visible to this token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)