Skip to main content
POST
/
api
/
v2
/
leads
/
{leadId}
/
enrich
Enrich a lead
curl --request POST \
  --url https://api.example.com/api/v2/leads/{leadId}/enrich
Enriches a specific lead with LinkedIn URL and/or email. Consumes credits. Same engine as the extension lookup surface, but scoped to a lead row you already have.

​
Body

FieldTypeDescription
requested_outputsarray (required)["linkedin_url"], ["email"], or both
email_modeenum"verified" or "any". Default "any".

​
Response

{
  "leadId": 1234,
  "x_profile_id": "1234567890",
  "result": {
    "ok": true,
    "kind": "resolved",
    "linkedin": { "url": "https://linkedin.com/in/alice", "confidence": "high" },
    "email": { "address": "alice@acme.com", "status": "verified", "provider": "prospeo" }
  },
  "credits_remaining": 47,
  "contact_routes": [
    { "routeType": "linkedin_url", "value": "...", "confidence": "high" }
  ]
}

​
Errors

CodeHTTPWhen
lead_not_found404Lead not owned by user
profile_missing404x_profiles row not in DB
credits_exhausted429Team credit balance too low
no_team400User has no team membership

​
Auth

Bearer API key.