---
title: "Recent notification emails and their delivery state"
method: GET
path: "/v1/notifications"
tags: ["Notifications"]
---

# Recent notification emails and their delivery state

`GET /v1/notifications`

## Request

- Base URL: `https://api.ironfang.com/audit`
- URL: `https://api.ironfang.com/audit/v1/notifications`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns recent notification-email records for the authenticated organisation and their recorded delivery states.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Notifications

- NotificationList
  - `next_cursor` string: Opaque continuation boundary. Absent on the final page; no total is inferred from a page.
  - `notifications` Notification[], required
    - `attempt` integer, required
    - `created_at` string, date-time, required
    - `event_id` string, uuid, required
    - `event_type` string, required
    - `id` string, uuid, required
    - `last_error` string
    - `recipient` string, required
    - `sent_at` string, date-time
    - `status` 'queued' | 'held' | 'sending' | 'sent' | 'failed', required

## Other responses

- `400`: Problem response

---

[API](https://skmtc.dev/ironfang/apis/ironfang-audit-api.md) · [All operations](https://skmtc.dev/ironfang/apis/ironfang-audit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ironfang/apis/ironfang-audit-api/revisions/7430deff2cbd?raw)