---
title: "Notification history (alerts that were sent), newest first"
method: GET
path: "/alerts"
---

# Notification history (alerts that were sent), newest first

`GET /alerts`

## Request

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

## Query parameters

- `limit` integer
- `offset` integer
- `domain_id` integer
- `status` string

## Response `200`

Paginated alerts

- object
  - `alerts` Alert[]
    - `id` integer
    - `status` string
    - `sent_at` string, date-time, nullable
    - `error_message` string, nullable: Delivery failure detail, when status is failed
    - `alert_level` string, nullable
    - `updated_at` string, date-time, nullable
    - `domain` object
      - `id` integer
      - `domain_name` string
    - `provider` object
      - `id` integer
      - `name` string
    - `event` object
      - `id` integer
      - `description` string
      - `event_type` object
        - `id` integer
        - `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)