Skip to Content
Uptimeify Docs

DNS Monitor Check-Historie abrufen

Gibt die letzten DNS-Check-Ergebnisse zurück.

GET /api/dns-monitors/:dnsMonitorPublicId/check-history

Authentifizierung

Erfordert eine gültige Session.

  • Header: Authorization: Bearer <token>

Parameter

  • dnsMonitorPublicId (Pfad, erforderlich): Öffentliche UUID des DNS Monitors.

Query Parameter

  • page (number, optional): Seite (Default: 1). Eine Seite zählt Prüfzyklen, nicht Zeilen: ein Zyklus hat eine Zeile je Standort.
  • limit (number, optional): Zyklen pro Seite (Default: 10; Max 100). Bei format=csv oder download=1 gelten die Export-Defaults (Default 10000, Max 50000 Zeilen).
  • status (string, optional): success oder failure (failure matcht auch timeout). Bei Minutenzeilen: kein Standort fehlgeschlagen bzw. mindestens einer.
  • minMs / maxMs (number, optional): Filter nach Response-Time-Bereich (timingTotal; bei Minutenzeilen der Minutendurchschnitt).
  • from / to (ISO-Datumsstring, optional): Filter nach checkedAt-Bereich.
  • format (string, optional): json (Default) oder csv.
  • download (string, optional): 1 erzwingt einen Attachment-Download, 0 (Default) liefert die Seite.

cURL

curl "https://YOUR_DOMAIN/api/dns-monitors/44444444-4444-4444-8444-444444444444/check-history?page=1&limit=10" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "data": [
    {
      "id": "33c53ac4-a2bc-475c-a904-8d3d6aab2979",
      "status": "success",
      "success": true,
      "errorMessage": null,
      "checkedAt": "2026-10-01T05:40:55.690Z",
      "responseTimeMs": 29,
      "location": { "name": "Paris (FR)", "code": "par" },
      "resolution": "raw"
    },
    {
      "id": "1min-2026-09-30T15:55:00.000Z",
      "status": "success",
      "success": true,
      "errorMessage": null,
      "checkedAt": "2026-09-30T15:55:00.000Z",
      "responseTimeMs": 54,
      "location": null,
      "resolution": "1min",
      "totalLocations": 2,
      "failedLocations": 0
    }
  ],
  "total": 864,
  "page": 17,
  "pageCount": 87,
  "resolution": "mixed",
  "rawWindowFrom": "2026-09-30T16:00:00.000Z"
}
  • resolution je Zeile: raw ist eine einzelne Prüfung mit Standort und Fehlermeldung; 1min ist eine Minute über alle Standorte, ohne Standort und Fehlermeldung, dafür mit totalLocations und failedLocations.
  • resolution der Seite: raw, 1min oder mixed (die Seite liegt über der Grenze).
  • rawWindowFrom: ab hier gibt es einzelne Prüfungen; ältere Zeilen sind Minutenzeilen.

Bei format=csv (oder download=1) ist die Response ein text/csv-Attachment (bzw. application/json bei format=json&download=1) anstelle der paginierten JSON-Antwort oben. CSV-Spalten: checkedAt,status,responseTimeMs,location,errorMessage,resolution.

Der JSON-Export (format=json&download=1) enthält je einzelner Prüfung zusätzlich diagnostics (Resolver-Antworten).

Aufbewahrung

Einzelne Prüfungen mit Standort und Fehlermeldung bleiben 24 Stunden erhalten. Ältere Einträge kommen aus den Minutenwerten (30 Tage), eine Zeile je Minute ohne Standort und Fehlermeldung. Tageswerte (24 Monate) stehen in den Monitor-Details.

Antwort (Response)

Gibt eine Liste von Check-Einträgen zurück. Siehe Fehlerliste für Fehlerantworten.

Häufige Fehler

  • 400 Bad Request (invalidRequestBody) wenn ein Query-Parameter ungültig ist: page/limit keine positive Ganzzahl, format weder json noch csv, download weder 0 noch 1, oder ein unbekannter Wert in status, minMs oder maxMs
  • 400 Bad Request (invalidDateRange) wenn from oder to kein Datum ist

Auf dieser Seite