Lemlist Developer Docs

Enrich Data

curl --request POST \
  --url https://api.lemlist.com/api/enrich \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'POST', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lemlist.com/api/enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://api.lemlist.com/api/enrich")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lemlist.com/api/enrich",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "id": "enr_ExampleA1b2C3d4E5"
}

POST

enrich

Enrich Data

curl --request POST \
  --url https://api.lemlist.com/api/enrich \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'POST', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lemlist.com/api/enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://api.lemlist.com/api/enrich")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lemlist.com/api/enrich",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "id": "enr_ExampleA1b2C3d4E5"
}

The API provides the ability to request data (email, phone number, LinkedIn information) in multiple ways:

Given some input (email, LinkedIn URL, etc.) for a single enrichment, with this endpoint
For a lead already in lemlist, with Enrich Lead
Many at once, with Bulk Enrich Data

All enrichment APIs are asynchronous: they answer with an enrichment id and the work runs in the background. There are two ways to retrieve your enriched data:

Webhooks (recommended): receive an enrichmentDone or enrichmentError event as soon as the enrichment is over, on your team’s webhooks and on the webhookUrl passed here. See Enrichment webhooks.
Polling: call Get Enrichment Result with the id.

Every call starts a new enrichment and uses credits, even when the same person was enriched before.

When the enrichment cannot be started, the answer carries a code and a message: see Request errors.

Result

Sample enrichmentDone webhook

{
    "type": "enrichmentDone",
    "data": [
        {
            "id": "enr_ExampleA1b2C3d4E5",
            "data": {
                "find_email": {
                    "email": "john@example.com",
                    "notFound": false,
                    "status": "deliverable"
                },
                "find_phone": {
                    "phone": "+15555550100",
                    "notFound": false
                },
                "linkedin_enrichment": {
                    "linkedinUrl": "https://www.linkedin.com/in/john-doe",
                    "firstName": "John",
                    "lastName": "Doe",
                    "tagline": "Marketing Manager at Acme Inc",
                    "occupation": "Marketing Manager",
                    "locationName": "Paris, Île-de-France, France",
                    "industry": "Software Development",
                    "companyName": "Acme Inc",
                    "companyDomain": "example.com",
                    "companyLinkedinUrl": "https://www.linkedin.com/company/example",
                    "companyWebsite": "https://example.com",
                    "companyIndustry": "Software Development",
                    "companySize": "51-200",
                    "positionGroups": [
                        {
                            "company": {
                                "name": "Acme Inc",
                                "linkedinUrl": "https://www.linkedin.com/company/example/",
                                "domain": "example.com",
                                "website": "https://example.com",
                                "industry": "Software Development",
                                "size": "51-200"
                            },
                            "date": {
                                "start": { "month": 3, "year": 2024 },
                                "end": {}
                            },
                            "profilePositions": [
                                {
                                    "title": "Marketing Manager",
                                    "companyName": "Acme Inc",
                                    "date": {
                                        "start": { "month": 3, "year": 2024 },
                                        "end": {}
                                    }
                                }
                            ]
                        }
                    ]
                }
            },
            "metadata": {}
        }
    ]
}

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

findEmail

boolean

Find the person's email. On when set to true.

verifyEmail

boolean

Verify the deliverability of email. On when set to true.

linkedinEnrichment

boolean

Enrich the person's LinkedIn profile. On when set to true.

string

Email address of the person

linkedinUrl

string

LinkedIn profile URL of the person

firstName

string

First name of the person

lastName

string

Last name of the person

companyDomain

string

Domain of the person's company

companyName

string

Name of the person's company

jobTitle

string

Job title of the person. Optional hint that improves the find rate when matching the right person.

findPhone

boolean

Find the person's phone number. On when set to true.

webhookUrl

string

URL that receives the enrichmentDone or enrichmentError event of this enrichment, on top of your team's webhooks. See the webhooks of the Enrichment object.

Response

Enrichment started

string

Enrichment ID

Getting started

Popular Resources

Endpoints

Objects & Definitions

Enrich Data

Result

Authorizations

Query Parameters

Response

​Result

Authorizations

Query Parameters

Response

Result