Skip to main content
GET
/
unsubscribes
/
{email}
Get Unsubscribe by Email
curl --request GET \
  --url https://api.lemlist.com/api/unsubscribes/{email} \
  --header 'Authorization: Basic <encoded-value>'
{
  "_id": "uns_Y9Lf5R2mpNWs8x0cz",
  "createdAt": "2023-06-12T10:45:21.367Z",
  "value": "john.doe@example.com",
  "source": "user"
}
This endpoint retrieves unsubscribe information for a specific email address.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
email
string<email>
required

Email address to check unsubscribe status

Response

Success

​
_id
string

Unique identifier for the unsubscribe entry

​
createdAt
string<date-time>

Timestamp when the unsubscribe entry was created

​
value
string

The unsubscribed email address

​
source
string

Source of the unsubscribe (e.g., user, lead, abuse, bounce, api)