API Reference · crm record

Enrich Lemlist contacts via API

Enrich Lemlist contacts before a campaign to cut bounce rate.

Endpoint

POST https://api.cleanlist.ai/v1/enrich/lemlist_contact

Request

POST https://api.cleanlist.ai/v1/enrich/lemlist_contact
Authorization: Bearer clnl_live_...
Content-Type: application/json

{
  "email": "jane@acme.com"
}

Response

{
  "id": "ev_abc123",
  "lemlist_contact": {
    "lemlist_contact_id": "<lemlist_contact_id>",
    "email": "<email>",
    "mx_verified": "<mx_verified>",
    "title": "<title>",
    "company": "<company>"
  },
  "meta": {
    "credits_used": 11,
    "providers_queried": 15
  }
}

Field reference

FieldTypeDescription
lemlist_contact_idstring
emailstring
mx_verifiedstring
titlestring
companystring

Code samples

curl
curl -X POST https://api.cleanlist.ai/v1/enrich/lemlist_contact \
  -H "Authorization: Bearer $CLEANLIST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@acme.com"}'
Node.js
import Cleanlist from "cleanlist";

const client = new Cleanlist(process.env.CLEANLIST_API_KEY);

const result = await client.enrich.lemlist_contact({
  email: "jane@acme.com",
});
console.log(result.lemlist_contact.title);
Python
from cleanlist import Cleanlist

client = Cleanlist(api_key=os.environ["CLEANLIST_API_KEY"])

result = client.enrich.lemlist_contact(email="jane@acme.com")
print(result["lemlist_contact"]["title"])

Pricing

Credit-based, no per-seat fees. This endpoint uses the standard enrichment rate:

  • Email only: 1 credit per enriched lemlist_contact.
  • Email + phone: 11 credits per enriched lemlist_contact.
  • Free tier: 30 credits/mo. See all pricing.

Next steps

30 credits included. No credit card required. Set up in 5 minutes.