Lemlist Developer Docs

Get Unsubscribe by Email

curl --request GET \
  --url https://api.lemlist.com/api/unsubscribes/{email} \
  --header 'Authorization: Basic <encoded-value>'

{
  "_id": "uns_ZfdZWc7dvCqXdgQmb",
  "createdAt": "2023-06-12T10:45:21.367Z",
  "value": "john.doe@example.com",
  "source": "user"
}

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_ZfdZWc7dvCqXdgQmb",
  "createdAt": "2023-06-12T10:45:21.367Z",
  "value": "john.doe@example.com",
  "source": "user"
}

This endpoint is legacy. Use Get Unsubscribed Variable instead.

Authorization

string

header

required

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

string<email>

required

Email address to check unsubscribe status

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)

⌘I