---
title: "Get FTP Monitor Check History"
description: "Returns recent FTP check results for a monitor."
---

`GET /api/ftp-monitors/:ftpMonitorPublicId/check-history`

## Authentication

`Authorization: Bearer <token>`

## Parameters

- `ftpMonitorPublicId` (Path, required): FTP monitor public UUID.
- `limit` (Query, optional): Number of results (default: 50, max: 200)

## Example (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X GET \
  "$BASE_URL/api/ftp-monitors/55555555-5555-4555-8555-555555555555/check-history?limit=25" \
  -H "Authorization: Bearer $TOKEN"
```

## Example Response

```json
{
  "data": [
    {
      "id": "2fd6d5ab-1e2a-4b4f-9c42-0f3a33a4a1d2",
      "status": "success",
      "errorMessage": null,
      "warningMessage": null,
      "timingFtp": 123,
      "diagnostics": {
        "message": "FTP connection successful"
      },
      "checkedAt": "2026-02-25T10:05:00.000Z",
      "locationId": 7,
      "locationName": "Nuremberg (DE)",
      "locationCode": "de-nbg"
    }
  ]
}
```

## Common Errors

- `400 FTP monitor public ID (UUID) required` if `ftpMonitorPublicId` is missing or invalid
- `401 Unauthorized` if you are not authenticated
- `403 Forbidden` if you do not have access
- `404 FTP monitor not found` if the monitor does not exist