Skip to main content
GET
/
unsubscribes
Get Many Unsubscribes
curl --request GET \
  --url https://api.lemlist.com/api/unsubscribes \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "_id": "uns_Y9Lf5R2mpNWs8x0cz",
    "createdAt": "2023-06-12T10:45:21.367Z",
    "value": "john.doe@example.com",
    "source": "user"
  }
]
This endpoint uses the Unsubscribe object.
This endpoint retrieves a list of all unsubscribed emails and domains.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

​
offset
integer

Offset for pagination

​
limit
integer

Number of unsubscribes to retrieve. Default: 100

Response

Success

​
_id
string

Unique unsubscribe identifier

​
email
string<email>

Unsubscribed email address

​
campaignId
string

Campaign ID from which the person unsubscribed

​
campaignName
string

Campaign name from which the person unsubscribed

​
unsubscribedAt
string<date-time>

Unsubscribe timestamp

​
scope
enum<string>

Unsubscribe scope

Available options:
campaign,
team,
global