---
title: "Events after a cursor, oldest first"
method: GET
path: "/api/v1/events"
---

# Events after a cursor, oldest first

`GET /api/v1/events`

## Request

- Base URL: `https://uidwatch.tollwyn.com`
- URL: `https://uidwatch.tollwyn.com/api/v1/events`
- Auth: HTTP bearer

Keep next_cursor and ask again with it: every event comes exactly once.

## Query parameters

- `cursor` string
- `limit` integer
- `kind` 'bankruptcy' | 'composition' | 'debt_enforcement' | 'liquidation' | 'deletion' | 'deficiency' | 'change' | 'new_entry'
- `historical` 'true' | 'false'
- `uid` string
- `group` string

## Response `200`

A page of events.

- object
  - `events` Event[], required
    - `id` string, uuid, required
    - `cursor` string, required: Its place in the stream, for ?cursor=
    - `kind` 'bankruptcy' | 'composition' | 'debt_enforcement' | 'liquidation' | 'deletion' | 'deficiency' | 'change' | 'new_entry', required
    - `historical` boolean, required: Published before the entry was added; never posted to webhooks
    - `uid` string, required
    - `group` string, required
    - `reference` string, required
    - `company_name` string, required
    - `changes` string[], required: Change fields of a register change (HR02)
    - `publication` object, required
      - `id` string, uuid, required
      - `number` string, required
      - `date` string, date, required
      - `rubric` string, required
      - `sub_rubric` string, required
      - `title` object, required
        - `en` string, required
        - `de` string, required
        - `fr` string, required
        - `it` string, required
      - `text` string, nullable, required: Register text of HR publications
      - `url` string, required: The notice in the gazette
      - `pdf_url` string, required: Its signed PDF, the binding version
    - `detected_at` string, date-time, required
    - `test` boolean, required
  - `next_cursor` string, required: The cursor for the next request
  - `has_more` boolean, required

## Other responses

- `401`: No valid API key (unauthorized).
- `422`: The query is not valid (invalid_request, invalid_uid).
- `429`: Too many requests (rate_limited); see the Retry-After header.

---

[API](https://skmtc.dev/tollwyn/apis/uidwatch-api.md) · [All operations](https://skmtc.dev/tollwyn/apis/uidwatch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tollwyn/apis/uidwatch-api/revisions/198aa0efb0f6?raw)