Uptimeify Docs

DNS Monitore auflisten

Listet DNS-Monitore einer Organisation (mit Pagination) auf.

GET /api/dns-monitors

Jedes Item enthält nur den DNS-Monitor selbst und bettet keinen vollständigen Kunden-Datensatz ein.

Query Parameter

  • organizationId (optional): Standard ist deine Session-Organisation
  • customerId (optional)
  • search (optional)
  • page (optional, Default 1)
  • perPage (optional, Default 50, max 200)

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET \
  "$BASE_URL/api/dns-monitors?organizationId=1&page=1&perPage=50" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Beispiel-Antwort

{
  "items": [
    {
      "id": 5,
      "publicId": "79fbe9b0-f9c6-4026-86de-1dbebc84d9bb",
      "organizationId": 2,
      "customerId": 2,
      "customerName": "Zaskoku & Haupt GbR",
      "name": "Primary DNS Monitor",
      "hostname": "claas.sh",
      "checkInterval": 30,
      "timeoutSeconds": 30,
      "dnsConfig": {},
      "allowedCheckCountryCodes": null,
      "status": "active",
      "notificationPhoneNumber": null,
      "notificationEmail": null,
      "lastCheckedAt": "2026-04-03T14:54:56.561Z",
      "createdAt": "2026-04-03T14:54:56.383Z",
      "updatedAt": "2026-04-03T14:54:56.740Z",
      "uptimeDay": "100.00",
      "uptimeMonth": "99.87",
      "uptimeYear": "99.94",
      "avgResponseDay": 24,
      "avgResponseMonth": 27,
      "avgResponseYear": 26,
      "responseGraph": { "values": [24, 25, null], "avg": 24 },
      "upSinceAt": "2026-04-01T08:12:03.000Z",
      "isDown": false,
      "tags": []
    }
  ],
  "total": 0,
  "page": 1,
  "perPage": 50
}

"total": 0, "page": 1, "perPage": 50 }


## Inline-Metriken

Jeder Eintrag traegt dieselben verdichteten Kennzahlen, die auch die uebrigen Monitor-Listen
liefern. Sie werden je Monitor ueber den Kalendertag, den Monat und das Jahr in UTC gebildet.

| Feld | Typ | Bedeutung |
|------|-----|-----------|
| `uptimeDay` / `uptimeMonth` / `uptimeYear` | string | Verfuegbarkeit in Prozent mit zwei Nachkommastellen, z. B. `"99.94"` |
| `avgResponseDay` / `avgResponseMonth` / `avgResponseYear` | number \| null | Mittlere Antwortzeit in Millisekunden; `null`, wenn in dem Fenster nichts gemessen wurde |
| `responseGraph` | object | `{ values, avg }` fuer die letzten 24 Stunden, ein Eintrag je Stunde; eine Stunde ohne erfolgreiche Pruefung ist `null` |
| `upSinceAt` | string \| null | ISO-Zeitpunkt, seit dem der Monitor laeuft, `null` solange er ausgefallen ist |
| `isDown` | boolean | Ob der Monitor gerade in einem unaufgeloesten Vorfall steckt |

Die Tageswerte kommen aus den Rohdaten, Monat und Jahr aus fortlaufenden Aggregaten -- in diesen
beiden Fenstern kann ein Wert der neuesten Pruefung daher um einige Minuten hinterherhinken.

Auf dieser Seite