Skip to main content
GET
/
leads
/
{email}
Get Lead by Email
curl --request GET \
  --url https://api.lemlist.com/api/leads/{email} \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "_id": "lea_mizMsAEkRrJuhouYe",
    "updatedAt": "2025-10-28T00:40:39.230Z",
    "isPaused": false,
    "state": "scanned",
    "status": "review",
    "personalized": false,
    "source": "api",
    "variables": {
      "firstName": "Bastien",
      "lastName": "Velitchkine",
      "companyName": "lemlist",
      "jobTitle": "GTM Engineer",
      "companyDomain": "bvelitchkine.com",
      "email": "support@lemlist.com"
    },
    "contactId": "ctc_Rofmb6uNGyaPNZ2ni",
    "enrichment": {
      "emailStatus": "deliverable"
    },
    "campaign": {
      "id": "cam_9NsHPnykWESTncCW8",
      "name": "NEW TO DELETE",
      "status": "draft"
    },
    "sendingUser": {}
  }
]
This endpoint uses the Lead object.
This endpoint retrieves a lead by their email address.
You must set the mandatory query parameter version to version=v2.

​
Lead Status

Lead status can be:
  • notInterested
  • interested
  • unsubscribed
  • review - to launch in the app
  • scanning - enriching in the app
  • running - in progress in the app
  • paused
  • done - completed in the app

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

The email address of the lead

Query Parameters

​
version
enum<string>
default:v2

API version. v2 is the only option

Available options:
v2

Response

Success

​
_id
string

Unique lead identifier

​
updatedAt
string<date-time>

Last update timestamp

​
isPaused
boolean

Whether the lead is paused

​
state
string

Current state of the lead (e.g., scanned, contacted)

​
status
string

Current status (e.g., review, done)

​
personalized
boolean

Whether the lead has personalized content

​
source
string

Source of the lead (e.g., api, csv)

​
variables
object

Custom variables associated with the lead

​
contactId
string

Associated contact ID

​
enrichment
object

Enrichment data

​
campaign
object

Campaign information

​
sendingUser
object

Sending user information