Skip to main content
GET
/
leads
Get Lead by Email or ID
curl --request GET \
  --url https://api.lemlist.com/api/leads \
  --header 'Authorization: Basic <encoded-value>'
{
  "firstName": "Bastien",
  "lastName": "Velitchkine",
  "companyName": "lemlist",
  "jobTitle": "GTM Engineer",
  "companyDomain": "bvelitchkine.com",
  "email": "[email protected]",
  "_id": "lea_mizMsAEkRrJuhouYe",
  "isPaused": false,
  "campaignId": "cam_9NsHPnykWESTncCW8",
  "contactId": "ctc_Rofmb6uNGyaPNZ2ni",
  "emailStatus": "deliverable"
}
This endpoint uses the Lead object. Make sure to also check the Contact object to understand the distinction between the two.
You should use at least one query parameter: email or id. If both are provided, the email will take precedence.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
id
string

The lead ID. You should use at least one of 'email' or 'id'.

​
email
string

The lead email. You should use at least one of 'email' or 'id'.

​
version
enum<string>

API version. v2 is the only option

Available options:
v2

Response

Success

​
email
string<email>

Email address of the lead

​
firstName
string

First name of the lead

​
lastName
string

Last name of the lead

​
companyName
string

Company name

​
jobTitle
string

Job title

​
companyDomain
string

Company domain

​
_id
string

Unique identifier for the lead

​
isPaused
boolean

Indicates if the lead is paused

​
campaignId
string

ID of the campaign the lead is associated with

​
contactId
string

Associated contact ID (if any)

​
emailStatus
string

Email status of the lead