---
title: "Change events across all domains, newest first"
method: GET
path: "/events"
---

# Change events across all domains, newest first

`GET /events`

## Request

- Base URL: `https://www.domainlab.app/api/v1`
- URL: `https://www.domainlab.app/api/v1/events`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer
- `domain_id` integer
- `event_type_id` integer

## Response `200`

Paginated events, each including domain: { id, domain_name }

- object
  - `events` Event[]
    - `id` integer
    - `detected_at` string, date-time
    - `description` string
    - `status` string, nullable
    - `payload` object, nullable: Before/after detail of the change
    - `created_at` string, date-time
    - `event_type` object
      - `id` integer
      - `name` string
      - `description` string, nullable
    - `domain` object: Present on GET /events (cross-domain listing) only
      - `id` integer
      - `domain_name` string
  - `total` integer
  - `limit` integer
  - `offset` integer

## Other responses

- `401`: Missing or invalid API key
- `403`: Account lacks API access (no active subscription or trial)
- `429`: Rate limit or monthly quota exceeded. Respect the Retry-After header. code is RATE_LIMITED (short-lived) or MONTHLY_QUOTA_EXCEEDED (resets next period).

---

[API](https://skmtc.dev/domainlab/apis/domain-lab-api.md) · [All operations](https://skmtc.dev/domainlab/apis/domain-lab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domainlab/apis/domain-lab-api/revisions/5dade951c661?raw)