Claim 250 credits on our Scale plan for free

Enrich API responses via API

Decorate third-party API responses with Cleanlist enrichment inline.

POSThttps://api.cleanlist.ai/v1/enrich/api_response

AuthorizationBearer clnl_live_…

Content-Typeapplication/json

{
  "email": "jane@acme.com"
}
  • 1 creditA verified work email, however many providers it took to find it.
  • 11 creditsEmail and direct dial together, on the same call.
  • 25+ providersQueried in cost order. The first source that returns wins, and a miss costs nothing.
  • 98% / 85%Verified work email and direct dial, measured on a 500-lead stratified test.

One call in.3 fields back.

The payload for a single api response lookup, and every field the record can carry. Same shape on every plan.

Response200 OK · api_response
{
  "id": "ev_abc123",
  "api_response": {
    "upstream_id": "<upstream_id>",
    "upstream_response": "<upstream_response>",
    "cleanlist_additions": "<cleanlist_additions>"
  },
  "meta": {
    "credits_used": 11,
    "providers_queried": 25
  }
}
Field reference3 fields
  • upstream_idstring
  • upstream_responsestring
  • cleanlist_additionsstring

Call it from anything.Pay for what comes back.

One POST from curl, Node or Python. Credits are drawn from one wallet the whole team shares, and a call that finds nothing is never charged.

Client librariesenrich.api_response
curl
curl -X POST https://api.cleanlist.ai/v1/enrich/api_response \
  -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.api_response({
  email: "jane@acme.com",
});
console.log(result.api_response.title);
Python
from cleanlist import Cleanlist

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

result = client.enrich.api_response(email="jane@acme.com")
print(result["api_response"]["title"])
What a call costsper api_response
  • SearchFree, unlimited
  • Verified work email1 credit
  • Direct dial10 credits
  • Email and direct dial11 credits
  • Validation0.5 credits
  • AI qualification5 credits
  • A call that finds nothing0

One shared wallet across the team. The Free plan runs on 30 credits a month.

See all pricing

Enrich API responses in production.

The public API is on Pro and Scale. Search costs nothing on every plan, and a call that returns nothing is never charged.

Start free trialRead the API reference

Related reading: data enrichment and waterfall enrichment. Plans and credit rates are on pricing.