Skip to main content
GET
Get Enrichment Result
This endpoint retrieves the state and results of an enrichment by its ID. The HTTP status follows enrichmentStatus:
Prefer webhooks to polling: lemlist calls your endpoint as soon as the enrichment is over.

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

enrichId
string
required

Enrichment ID returned when the enrichment was started

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

enrichmentId
string

Identifier of the enrichment

enrichmentStatus
enum<string>

Lifecycle state of the enrichment, not to be confused with data.email.status. Each state comes with its own HTTP status: done 200, in-progress 202, failed 400, not-found 404. A cancelled enrichment answers done.

Available options:
done,
in-progress,
failed,
not-found
input
object

The inputs the enrichment was started with, echoed back. Absent on not-found.

data
object

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.

failedWorkflows
enum<string>[]

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.

Available options:
find_email,
find_phone,
verify,
linkedin_enrichment
code
enum<string>

On failed, why the enrichment failed. An unknown or missing cause reads as FAILED_TO_PROCESS.

Available options:
FAILED_TO_PROCESS,
INVALID_INPUT,
PROVIDER_TIMEOUT,
PROVIDER_REJECTED
reason
string

On failed, a human-readable explanation of code, possibly translated to the language of the API user. Branch on code, never on reason.

error
string

On failed, the raw cause stored on the enrichment, absent when none was stored; prefer code. On not-found, Enrichment not found.