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": "John",
  "lastName": "Doe",
  "companyName": "lemlist",
  "jobTitle": "GTM Engineer",
  "companyDomain": "example.com",
  "email": "support@lemlist.com",
  "_id": "lea_fiDpiGV585wy3Oii2",
  "isPaused": false,
  "campaignId": "cam_bSn8EORHQxbWPjHvu",
  "contactId": "ctc_xW8Ou6C03Csv8vatp",
  "emailStatus": "deliverable"
}

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 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