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-OrganisationcustomerId(optional)search(optional)page(optional, Default1)perPage(optional, Default50, max200)
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.