Skip to main content
POST
/
api
/
v1
/
enrich
/
database
/
leads
/
bulk
/
Start bulk lead enrich (database)
curl --request POST \
  --url https://api.generect.com/api/v1/enrich/database/leads/bulk/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "leads": [
    {
      "linkedin_url": "https://www.linkedin.com/in/jordan-ellis"
    },
    {
      "id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
    }
  ]
}
'
{
  "data": null,
  "meta": {
    "job_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "status": "pending",
    "total": 2,
    "processed": 0,
    "amount_charged": 0,
    "error": null
  }
}

​
Use Case:

Enrich many leads at once from cached data — submit up to 50 identifiers and poll the job or receive a completion webhook.

​
Pricing

This is a billable endpoint — you are charged only for each lead that is found and enriched. Leads not found are free.
Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →

Authorizations

​
Authorization
string
header
required

Use the required Token prefix. Example: Authorization: Token xxxxxxxxx

Body

application/json
​
leads
(By Lead ID · object | By LinkedIn URL · object | By Email · object)[]
required

Leads to enrich (max 50 per request). Each entry provides exactly one identifier: id, linkedin_url, or email.

Maximum array length: 50

Response

Bulk job accepted

​
data
object | null

Always null — results arrive via the bulk status endpoint.

​
meta
object

Bulk job state. Poll the bulk status endpoint with job_id or subscribe to the completion webhook.