Status-API

Alle Daten dieser Statusseite sind auch als JSON verfügbar. So können Sie den Status von seven.io in eigene Dashboards, Monitoring-Systeme oder Status-Widgets einbinden.

Die Endpunkte sind öffentlich, benötigen keine Authentifizierung und erlauben Cross-Origin-Requests (Access-Control-Allow-Origin: *). Alle Zeitstempel sind ISO 8601 in UTC.

Aktueller Status

GEThttps://status.seven.io/api/v1/statusLiefert den Gesamtstatus sowie alle Komponenten und Komponentengruppen.

{
  "status": "operational",
  "components": [
    {
      "id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
      "name": "SMS Gateway",
      "description": "SMS sending and delivery",
      "status": "operational",
      "position": 0,
      "groupId": "9f8e7d6c-5b4a-3210-fedc-ba9876543210",
      "showUptime": true,
      "lastCheckAt": "2026-08-25T09:12:00.000Z",
      "createdAt": "2025-01-08T10:00:00.000Z"
    }
  ],
  "groups": [
    {
      "id": "9f8e7d6c-5b4a-3210-fedc-ba9876543210",
      "name": "Messaging",
      "description": null,
      "position": 0,
      "createdAt": "2025-01-08T10:00:00.000Z"
    }
  ]
}

status auf oberster Ebene ist der schlechteste Status aller Komponenten. components.groupId verweist auf groups.id, position bestimmt die Anzeigereihenfolge.

Mögliche Werte für status: operational, degraded_performance, partial_outage, major_outage, under_maintenance

Störungen und Wartungen

GEThttps://status.seven.io/api/v1/incidentsLiefert die letzten 20 Einträge, neueste zuerst, jeweils inklusive aller Updates und betroffenen Komponenten.

[
  {
    "id": "1122aabb-ccdd-4eef-8899-001122334455",
    "type": "incident",
    "title": "Delayed SMS delivery",
    "status": "resolved",
    "impact": "minor",
    "autoCreated": false,
    "scheduledFor": null,
    "scheduledUntil": null,
    "postmortemBody": null,
    "postmortemPublishedAt": null,
    "createdAt": "2026-08-20T08:30:00.000Z",
    "updatedAt": "2026-08-20T09:45:00.000Z",
    "resolvedAt": "2026-08-20T09:45:00.000Z",
    "updates": [
      {
        "id": "5566ddee-7788-4aab-9900-aabbccddeeff",
        "incidentId": "1122aabb-ccdd-4eef-8899-001122334455",
        "status": "resolved",
        "body": "Delivery is back to normal.",
        "createdAt": "2026-08-20T09:45:00.000Z"
      }
    ],
    "affectedComponents": [
      { "id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789", "name": "SMS Gateway" }
    ]
  }
]

Mögliche Werte für type: incident, maintenance

Mögliche Werte für status: investigating, identified, monitoring, resolved, scheduled, in_progress

Mögliche Werte für impact: none, minor, major, critical

Bei type = maintenance sind scheduledFor und scheduledUntil gesetzt, bei Störungen sind sie null. resolvedAt ist gesetzt, sobald der Eintrag abgeschlossen ist.

Metriken

GEThttps://status.seven.io/api/v1/metrics?range=dayLiefert alle auf der Statusseite angezeigten Metriken samt Messpunkten für den gewählten Zeitraum.

[
  {
    "id": "aabbccdd-1122-4334-9556-778899aabbcc",
    "name": "SMS API response time",
    "suffix": "ms",
    "position": 0,
    "displayMin": 0,
    "displayMax": null,
    "createdAt": "2025-01-08T10:00:00.000Z",
    "points": [
      { "value": 128.4, "timestamp": "2026-08-25T09:00:00.000Z" },
      { "value": 131.7, "timestamp": "2026-08-25T09:05:00.000Z" }
    ]
  }
]

Mögliche Werte für range (Standard: day): day, week, month

Mit offset blättern Sie zeitlich zurück: offset=1 liefert den vorherigen Zeitraum (z. B. gestern bei range=day), offset=2 den davor usw. Da Messpunkte 31 Tage aufbewahrt werden, sind maximal 30 Tage bzw. 3 Wochen zurück möglich, bei month nur offset=0.

Die Messpunkte sind aggregiert: 5-Minuten-Buckets bei day, Stunden-Buckets bei week, Tages-Buckets bei month, jeweils als 95. Perzentil. suffix ist die Einheit für die Anzeige (z. B. ms), displayMin und displayMax sind optionale Achsengrenzen und können null sein.

Feeds

Für Benachrichtigungen über neue Einträge gibt es zusätzlich Atom- und RSS-Feeds.

/history.atom /history.rss

Hinweise

Bitte parsen Sie nicht das HTML dieser Statusseite. Nutzen Sie die JSON-Endpunkte, deren Struktur bleibt stabil.
Die Antworten werden nicht zwischengespeichert. Ein Abruf im Minutentakt reicht für die meisten Anwendungsfälle aus.
Es können jederzeit neue Felder hinzukommen. Ignorieren Sie unbekannte Felder, statt sich auf eine feste Feldliste zu verlassen.