Bulk Enrich Data

Performs batch enrichment for up to 500 entities to find emails, phone numbers, or LinkedIn data.

POST /v2/enrichments/bulk

cURL

find_email

curl --request POST \ --url https://api.lemlist.com/api/v2/enrichments/bulk \ --header 'Authorization: Basic <encoded-value>' \ --header 'Content-Type: application/json' \ --data ' [ { "input": { "companyName": "Example Ets", "companyDomain": "example.com", "firstName": "John", "lastName": "Doe" }, "enrichmentRequests": [ "find_email" ], "metadata": { "id": "some_id" } }, { "input": { "linkedinUrl": "https://www.linkedin.com/in/john-doe" }, "enrichmentRequests": [ "find_email" ], "metadata": "some_id" } ] '

200

find_email

[ { "id": "enr_rt3yG1uvSOAmNgsOm", "metadata": { "id": "some_id" } }, { "id": "enr_KdG7p3VNyiCgmcYTv", "metadata": "some_id" }, { "error": "MISSING_INPUTS", "metadata": "some_id" } ]

Unlike other endpoints, this one starts with /v2/enrichments.

How to use the endpoint

The bulk enrichment API is ideal for:

• Processing large lists of prospects efficiently
• Enriching CRM data in batches
• Finding and verifying multiple contacts simultaneously
• Automating data enrichment workflows at scale

Enrichment Types

Type	Required Input	Description
find_email	linkedinUrl OR (firstName + lastName + companyName + companyDomain)	Find and verify email addresses
find_phone	linkedinUrl	Find phone numbers
verify	email	Verify email deliverability
linkedin_enrichment	linkedinUrl OR email OR (firstName + lastName + (companyName OR companyDomain))	Enrich with LinkedIn profile data

Metadata

The metadata field can be a string or an object. This data will be returned in both the API response and webhook notifications, allowing you to track and correlate enrichment requests.

Response

The API returns an array where each element corresponds to a request in the input array. Successful requests return an enrichment ID, while failed requests return an error code.

success

{
  "id": "enr_cawQhM9N3pWkqw2Yt",
  "metadata": {
    "some_id": "some_id"
  }
}

{
  "error": "MISSING_INPUTS",
  "metadata": "some_id"
}

Getting Results

Check Enrich Data for details on the enrichment result structure.

Since enrichment is asynchronous, you can retrieve results in two ways:

1. Polling: Use the Get Enrichment Result endpoint with the returned enrichment ID
2. Webhooks: Provide a webhookUrl query parameter to receive notifications when enrichments complete

Learn more about webhooks in the Enrich object definition.

Error Codes

Error Code	Description
WRONG_INPUT_FORMAT	The input must be an object containing at least one valid field
WRONG_METADATA_FORMAT	The metadata field must be a string or an object
NO_WORKFLOW_REQUESTED	At least one enrichment type must be specified
WRONG_ENRICHMENT_REQUEST_FORMAT	The enrichmentRequests field must be an array
UNAUTHORIZED_WORKFLOW_REQUESTED	Invalid enrichment type specified
TOO_MANY_ENRICHMENTS_REQUESTED	Maximum 500 enrichments per request
NO_ENRICHMENTS_REQUESTED	The body must contain at least one enrichment
WRONG_BODY_FORMAT	The body must be a valid JSON array
MISSING_INPUTS	Required input fields are missing for the requested enrichment type
MISSING_EMAIL	Email is required for verify enrichment
MISSING_LINKEDIN_URL	LinkedIn URL is required for this enrichment type

Limits

• Maximum requests per call: 500 enrichments
• Rate limits: Standard API rate limits apply (20 requests per 2 seconds)
• Credits: Each enrichment type consumes credits from your team’s balance

See lemlist API credits for more information about credit consumption.

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

webhookUrl · string

Webhook URL for enrichment events

Body

application/json

Maximum array length: 500

enrichmentRequests · enum<string>[] · required

Array of enrichment types to perform. Must contain at least one of: find_email, find_phone, verify, linkedin_enrichment

Available options: find_email, find_phone, verify, linkedin_enrichment

Example:

["find_email", "verify"]

input · object

Input data for enrichment. Required fields depend on enrichmentRequests.

Show child attributes

metadata · string object

Custom data to be returned in the response and webhook. Can be a string or an object

Example:

{ "id": "some_id" }

Response

200

application/json

Success - Returns enrichment IDs and metadata for each request

Option 1

Option 2

id · string

Enrichment ID

Example:

"enr_KzCb0f9dbIjtRqyEO"

metadata · string object

The metadata provided in the request