---
title: "List audit events for a suppression"
method: GET
path: "/email_blocks/{id}/events"
tags: ["Email Suppressions"]
---

# List audit events for a suppression

`GET /email_blocks/{id}/events`

Offset pagination only (`page[number]` default 1, `page[size]`
default **50**, max 100). No `sort`, no `filter`, no cursor —
ordering is fixed `desc occurred_at, desc id`. Verifies the block
belongs to the account first (cross-account → 404).

## Query parameters

- `page[number]` integer
- `page[size]` integer

## Response `200`

Audit events (newest-first).

- EmailBlockEventListResponse
  - `data` EmailBlockEvent[], required
    - `id` string, uuid, required
    - `record_type` 'email_block_event', required — View-only.
    - `event_type` 'created' | 'removed' | 'expired' | 'override_used', required
    - `reason` string, required — Free-text snapshot of the block's reason at event time.
    - `source` string, required — Free-text snapshot of the block's source at event time.
    - `actor` string, required — Free-text (`user_id`/`org_id`/`api_key`/`dev_bypass`/`system`/`manual`).
    - `meta` object, nullable — `null` when the schema field is nil (the context usually sets it to `{}`).
    - `occurred_at` string, date-time, required
  - `meta` OffsetMeta, required
    - `page_number` integer, required
    - `page_size` integer, required
    - `total_pages` integer, required
    - `total_results` integer, required

## Other responses

- `400` — Query-param validation error (`source.pointer /<field>`).
- `401` — Missing or invalid gateway auth.
- `404` — Resource not found (cross-account lookups and malformed UUIDs also return 404 — no leak).
- `406` — Framework-rendered error (e.g. 406 Not Acceptable, 405 Method Not Allowed, 415 Unsupported Media Type). HTTP status matches the error and the body `code` carries that same status (e.g. `"406"`, not a hardcoded `"500"`). The explicit `500.json` clause still emits `code: "500"` for genuine 500s.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)