---
title: "Get all unsubscribed contacts"
method: GET
path: "/api/v2/unsubscribers"
tags: ["Contacts"]
---

# Get all unsubscribed contacts

`GET /api/v2/unsubscribers`

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Contacts/getUnsubscribers" target="_blank">Try in sandbox</a><br>When one of your message recipients sends a request with one of the [STOP-words](https://www.textmagic.com/sms-stop-command/), they will be immediately opted-out of your send lists and their contact status will change to an unsubscribed contact. To retrieve information on all contacts who have unsubscribed status, use:

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Returned when successful.

- GetUnsubscribersPaginatedResponse
  - `page` integer, required
  - `pageCount` integer, required — The total number of pages.
  - `limit` integer, required — The number of results per page.
  - `resources` UnsubscribedContact[], required
    - `id` integer, required — Unsubscribed contact ID.
    - `phone` string, required — Phone number in [E.164 format](https://en.wikipedia.org/wiki/E.164).
    - `unsubscribeTime` string, date-time, required — Time when contact was opted-out.
    - `firstName` string, nullable, required — Unsubscribed contact first name.
    - `lastName` string, nullable, required — Unsubscribed contact last name.

## Other responses

- `401` — Unauthorized request.

---

[API](https://skmtc.net/textmagic/apis/textmagic-api.md) · [All operations](https://skmtc.net/textmagic/apis/textmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textmagic/textmagic-api/revisions/3e4029d19684/schema)