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": "[email protected]"
    },
    "contactId": "ctc_Rofmb6uNGyaPNZ2ni",
    "enrichment": {
      "emailStatus": "deliverable"
    },
    "campaign": {
      "id": "cam_9NsHPnykWESTncCW8",
      "name": "NEW TO DELETE",
      "status": "draft"
    },
    "sendingUser": {}
  }
]
This endpoint uses the Lead object. Make sure to also check the Contact object to understand the distinction between the two.
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