---
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`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/email_blocks/{id}/events`
- Auth: HTTP bearer

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.

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/email_blocks/:id/events/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)