---
title: "List opt-outs"
method: GET
path: "/messaging_optouts"
tags: ["Opt-Out Management"]
---

# List opt-outs

`GET /messaging_optouts`

Retrieve a list of opt-out blocks.

## Query parameters

- `redaction_enabled` string
- `filter` object
  - `messaging_profile_id` string — The ID of the messaging profile to retrieve opt-outs for
  - `from` string — The sending address (+E.164 formatted phone number, alphanumeric sender ID, or short code) to retrieve opt-outs for
- `page` object
  - `number` integer — The page number to load
  - `size` integer — The size of the page
- `created_at` object
  - `gte` string, date-time — Filter opt-outs created after this date (ISO-8601 format)
  - `lte` string, date-time — Filter opt-outs created before this date (ISO-8601 format)

## Response `200`

Successful response with opt-out list data

- OptOutListResponse
  - `data` OptOutItem[]
    - `from` string — Sending address (+E.164 formatted phone number, alphanumeric sender ID, or short code).
    - `to` string — Receiving address (+E.164 formatted phone number or short code).
    - `messaging_profile_id` string, nullable — Unique identifier for a messaging profile.
    - `keyword` string, nullable — The keyword that triggered the opt-out.
    - `created_at` string, date-time — The timestamp when the opt-out was created
  - `meta` MessagingPaginationMeta0b38e7044b
    - `total_pages` integer, required
    - `total_results` integer, required
    - `page_number` integer, required
    - `page_size` integer, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[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)