---
title: "Sichere Startmarke erstellen"
method: GET
path: "/events/checkpoint"
tags: ["Ereignisse"]
---

# Sichere Startmarke erstellen

`GET /events/checkpoint`

## Request

- Base URL: `https://firmenwatch.ch/api/v1`
- URL: `https://firmenwatch.ch/api/v1/events/checkpoint`
- Auth: HTTP bearer

Liefert die aktuelle Stromepoche und High-Water-Marke. Vor einem Massenabgleich gespeichert, garantiert sie, dass jede danach eintreffende Aenderung anschliessend ueber /events?since_id=<high_water>&epoch=<epoch> gelesen werden kann.

## Response `200`

Aktueller Ereignis-Checkpoint.

- object
  - `data` EventCheckpoint, required
    - `stream` 'firmenwatch.ch/company-events', required: Stabile Bezeichnung des Ereignisstroms.
    - `epoch` string, required: Identitaet der physischen Stromfassung. Aendert sich bei einem Neuaufbau und macht einen alten sequence-Cursor erkennbar ungueltig.
    - `high_water` integer, required: Hoechste beim Erstellen sicher vorhandene Stromposition.
    - `created_at` string, date-time, required
    - `schema_version` '1.0', required

## Other responses

- `400`: Ungueltige Anfrage (invalid_request).
- `401`: Kein oder ungueltiger Schluessel (unauthorized).
- `402`: Monatskontingent erschoepft (quota_exceeded).
- `403`: Abonnement nicht aktiv oder benoetigtes Schluesselrecht fehlt (forbidden).
- `429`: Ratenbegrenzung erreicht (rate_limited).
- `500`: Unerwarteter Fehler (internal).
- `503`: Der Registerbestand wird gerade vollständig verifiziert (temporarily_unavailable). Dieselbe Abfrage später erneut senden.

---

[API](https://skmtc.dev/firmenwatch/apis/firmenwatch-api.md) · [All operations](https://skmtc.dev/firmenwatch/apis/firmenwatch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/firmenwatch/apis/firmenwatch-api/revisions/65e774135677?raw)