Uptimeify Docs

ICMP Monitore auflisten

Listet ICMP Monitore einer Organisation auf.

GET /api/icmp-monitors

Authentifizierung

Erfordert eine gültige Session.

  • Header: 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).

cURL

curl "https://YOUR_DOMAIN/api/icmp-monitors?page=1&perPage=50" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "items": [
    {
      "id": 123,
      "organizationId": 1,
      "customerId": 10,
      "customerName": "Example Customer",
      "name": "Core Router",
      "hostname": "10.0.0.1",
      "status": "active",
      "checkInterval": 30,
      "timeoutSeconds": 30,
      "port": null,
      "config": {
        "packetSize": 56,
        "count": 3
      },
      "notificationPhoneNumber": null,
      "notificationEmail": null,
      "lastCheckedAt": null,
      "createdAt": "2026-02-26T12:00:00.000Z",
      "updatedAt": "2026-02-26T12:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 50
}

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

Fehler

  • 400 Ungültige Query-Parameter (z. B. organizationId, customerId)
  • 401 Unauthorized
  • 403 Forbidden

Auf dieser Seite