---
title: "FTP Monitor Details abrufen"
description: "Gibt die FTP-Monitor-Detailseiten-Daten in einem Call zurück (Mega-Endpoint)."
---

`GET /api/ftp-monitors/:ftpMonitorPublicId/details`

## Authentifizierung

`Authorization: Bearer <token>`

## Parameter

- `ftpMonitorPublicId` (Pfad, erforderlich): Öffentliche UUID des FTP Monitors.

## Query Parameter

- `range` (optional): `day` (default), `week`, `month`, `year`
- `date` (optional): Referenzdatum (ISO String)
- `startDate` / `endDate` (optional): Überschreibt das Zeitfenster (ISO Strings)
- `granularity` (optional): Wenn weggelassen, kann der Server bei großen Zeiträumen automatisch aggregieren. Nutze `granularity=raw`, um Raw-Daten zu erzwingen.

## Beispiel (cURL)

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

curl -X GET \
  "$BASE_URL/api/ftp-monitors/55555555-5555-4555-8555-555555555555/details?range=day" \
  -H "Authorization: Bearer $TOKEN"
```

## Beispiel Response (Shape)

Die Response ist ein einzelnes Objekt mit diesen Top-Level Keys:

```json
{
  "ftpMonitorId": 400,
  "monitor": {},
  "latestCheck": {},
  "uptimeStats": {
    "day": "100.00",
    "month": "100.00",
    "year": "100.00",
    "dayAvgResponse": 120,
    "monthAvgResponse": 130,
    "yearAvgResponse": 140
  },
  "uptimeStatsMeta": {},
  "monitoringData": {
    "responseTimeData": [],
    "statusData": [],
    "uptimePercentage": "100.00",
    "checkSuccessRatePercentage": "100.00",
    "totalChecks": 10,
    "successfulChecks": 10
  },
  "incidents": {
    "history": [],
    "total": 0,
    "ongoing": 0,
    "totalDowntime": "0s"
  },
  "alerts": {
    "history": [],
    "total": 0,
    "notificationContext": {}
  },
  "testResultLog": null,
  "maintenance": {
    "inMaintenance": false,
    "activeWindows": [],
    "allWindows": []
  }
}
```

## Häufige Fehler

- `400 Invalid FTP monitor public ID (UUID)` wenn `ftpMonitorPublicId` ungültig ist
- `401 Unauthorized` wenn du nicht authentifiziert bist
- `403 Forbidden` wenn du keinen Zugriff hast
- `500 Failed to fetch FTP monitor details` bei Serverfehlern