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_fiDpiGV585wy3Oii2",
    "updatedAt": "2025-10-28T00:40:39.230Z",
    "isPaused": false,
    "state": "scanned",
    "status": "review",
    "personalized": false,
    "source": "api",
    "variables": {
      "firstName": "John",
      "lastName": "Doe",
      "companyName": "lemlist",
      "jobTitle": "GTM Engineer",
      "companyDomain": "example.com",
      "email": "support@lemlist.com"
    },
    "contactId": "ctc_xW8Ou6C03Csv8vatp",
    "enrichment": {
      "emailStatus": "deliverable"
    },
    "campaign": {
      "id": "cam_bSn8EORHQxbWPjHvu",
      "name": "NEW TO DELETE",
      "status": "draft"
    },
    "sendingUser": {}
  }
]

Documentation Index

Fetch the complete documentation index at: https://developer.lemlist.com/llms.txt

Use this file to discover all available pages before exploring further.

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