---
title: "FTP Monitore auflisten"
description: "Listet FTP Monitore einer Organisation auf."
---

`GET /api/ftp-monitors`

## Authentifizierung

`Authorization: Bearer <token>`

## Parameter

- `organizationId` (Query, optional): Organisations-ID. Default ist die Organisation des aktuellen Nutzers.
- `customerId` (Query, optional): Nach Kunden-ID filtern.
- `search` (Query, optional): Suche nach Name, Hostname oder Kunde.
- `page` (Query, optional): Seite (Default: 1).
- `perPage` (Query, optional): Einträge pro Seite (Default: 50, Max: 200).

Hinweis: Die Ergebnisse sind zusätzlich durch deinen Customer-Scope begrenzt (falls dein Account auf eine Teilmenge von Kunden eingeschränkt ist).

## Beispiel (cURL)

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

curl -X GET \
  "$BASE_URL/api/ftp-monitors?page=1&perPage=50&search=ftp" \
  -H "Authorization: Bearer $TOKEN"
```

## Response

```json
{
  "items": [
    {
      "id": 400,
      "organizationId": 1,
      "customerId": 10,
      "customerName": "Example Customer",
      "name": "Partner FTP",
      "hostname": "ftp.deinkunde.com",
      "port": 21,
      "status": "active",
      "checkInterval": 30,
      "timeoutSeconds": 30,
      "allowedCheckCountryCodes": null,
      "config": {
        "user": "monitor",
        "password": "<ftp-password>",
        "secure": false
      },
      "notificationPhoneNumber": null,
      "notificationEmail": null,
      "lastCheckedAt": null,
      "createdAt": "2026-02-25T10:00:00.000Z",
      "updatedAt": "2026-02-25T10:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 50
}
```

Jedes Item enthält den FTP-Monitor selbst und ein flaches `customerName`, aber keinen vollständig eingebetteten Kunden-Datensatz.

## Häufige Fehler

- `400 Invalid organizationId` wenn `organizationId` keine gültige Zahl ist
- `401 Unauthorized` wenn du nicht authentifiziert bist
- `403 Forbidden` wenn du keinen Zugriff auf die Organisation hast