---
title: "Get a list of unsubscribed users"
method: GET
path: "/smtp/unsubscribe"
tags: ["Unsubscribe"]
---

# Get a list of unsubscribed users

`GET /smtp/unsubscribe`

## Request

- Base URL: `https://api.sendpulse.com`
- URL: `https://api.sendpulse.com/smtp/unsubscribe`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (client credentials, token URL `https://api.sendpulse.com/oauth/access_token`)

## Query parameters

- `date` string, date
- `limit` integer
- `offset` integer

## Response `200`

List of unsubscribed users

- object[]
  - `email` string
  - `unsubscribe_by_link` integer
  - `unsubscribe_by_user` integer
  - `spam_complaint` integer
  - `date` string

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation error

---

[API](https://skmtc.dev/sendpulse/apis/sendpulse-smtp-api.md) · [All operations](https://skmtc.dev/sendpulse/apis/sendpulse-smtp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sendpulse/apis/sendpulse-smtp-api/revisions/9bab1dd9ec2e?raw)