curl --request GET \
--url https://api.lemlist.com/api/enrich/{enrichId} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.lemlist.com/api/enrich/{enrichId}"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.lemlist.com/api/enrich/{enrichId}', 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/{enrichId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.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/{enrichId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
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;
}Get Enrichment Result
Retrieves the state and results of an enrichment.
curl --request GET \
--url https://api.lemlist.com/api/enrich/{enrichId} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.lemlist.com/api/enrich/{enrichId}"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.lemlist.com/api/enrich/{enrichId}', 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/{enrichId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.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/{enrichId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
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;
}enrichmentStatus:
| Status | enrichmentStatus | Body |
|---|---|---|
200 | done | data holds the results; failedWorkflows lists the requested workflows that ended without any result (a find_email or find_phone that found nothing answers notFound: true in data instead). A cancelled enrichment also answers done. |
202 | in-progress | data is empty: poll again later. |
400 | failed | code and reason say why. |
404 | not-found | No enrichment with this ID in your team. |
Authorizations
Response
Done. data holds a key per requested workflow that produced a result, including a find_email or find_phone that found nothing (notFound: true); requested workflows that ended without any result are listed in failedWorkflows. A cancelled enrichment also answers done.
An enrichment: one request to find an email or a phone number, verify an email or enrich a LinkedIn profile for one person. This is the shape GET /enrich/{enrichId} answers with; webhooks carry the same results under other key names (see the Webhooks section).
What the enrichment found, keyed by result. Empty unless enrichmentStatus is done. A key is present only for a requested workflow that produced a result. A find_email or find_phone that found nothing still has its key, with notFound: true. A requested workflow that ended without any result has no key and is listed in failedWorkflows.
Show child attributes
Show child attributes
On done, the requested workflows that ended without any result; they have no key in data. A find_email or find_phone that found nothing is not listed: it answers notFound: true in data. A workflow lemlist runs on its own as a dependency of a requested one is never listed. Only present when not empty.
find_email, find_phone, verify, linkedin_enrichment Was this page helpful?