TL;DR: Pick partial for email-only (1 credit/find), full for email + phone (11 credits/find), phone_only to skip email lookup (10 credits/find), none to attach contacts without enrichment, or prospecting_only to discover new contacts at target companies.
Enrichment Types
The enrichment_type field on POST /api/v1/public/enrich/bulk controls which providers Cleanlist runs and what data ends up on each contact.
Quick comparison
| Type | What it does | Credit cost |
|---|---|---|
none | Attach contacts to your DEFAULT lead list, no enrichment | 0 |
partial | Find verified email addresses only | 1 per email found |
phone_only | Find personal phone numbers only | 10 per phone found |
full | Find both email and phone | 11 per full enrichment |
prospecting_only | Discover new contacts at target companies | 1 per discovered contact |
Failed lookups cost zero credits across every type.
none
Attach contacts to your DEFAULT lead list without running any enrichment. Useful when you already have all the data you need and just want the contacts to live inside Cleanlist (for portal viewing, CRM sync, smart columns, etc.).
{
"enrichment_type": "none",
"contacts": [
{
"first_name": "John",
"last_name": "Doe",
"company_domain": "acme.com"
}
]
}Cost: 0 credits.
partial (default)
Email-only enrichment. This is the default if you omit enrichment_type. Cleanlist runs the waterfall across email providers (Wiza, FindyMail, LeadMagic, Datagma, Hunter, IcyPeas, Prospeo, AnyMailFinder, etc.) and returns the first verified email it finds.
{
"enrichment_type": "partial",
"contacts": [
{ "linkedin_url": "https://www.linkedin.com/in/janedoe" }
]
}Cost: 1 credit per email found. 0 credits if no email is found.
The result includes:
primary_emailprimary_email_status(reliable,risky,unknown)other_emails— additional candidates the providers found- Prospect / company metadata (name, headline, location, domain, industry, headcount)
phone_only
Skip email enrichment and only look up personal phone numbers. Useful when you already have email coverage and just need phone for cold-call campaigns.
{
"enrichment_type": "phone_only",
"contacts": [
{ "linkedin_url": "https://www.linkedin.com/in/janedoe" }
]
}Cost: 10 credits per phone found. 0 credits if none found.
The result includes:
personal_phone_numbers(array of E.164 strings)- Prospect / company metadata
full
Run both email and phone enrichment. The most complete (and most expensive) mode.
{
"enrichment_type": "full",
"contacts": [
{ "linkedin_url": "https://www.linkedin.com/in/janedoe" }
]
}Cost: 11 credits when both email and phone are found. If only one is found, you're billed only for that one (1 for email, 10 for phone).
prospecting_only
Instead of enriching known contacts, discover new contacts at target companies. Provide companies (by domain or name) and let Cleanlist find people that match your criteria.
{
"enrichment_type": "prospecting_only",
"contacts": [
{
"company_domain": "acme.com",
"first_name": "VP",
"last_name": "Sales"
}
]
}The first_name / last_name / linkedin_url fields can be used to seed targeting criteria. Cleanlist returns the discovered contacts via the same workflow / webhook flow.
Cost: 1 credit per discovered contact. Failed discoveries cost 0 credits.
For larger prospecting campaigns with structured filters (job title, seniority, location, headcount, industry), use the Sales Navigator import feature inside the portal — see the Sales Navigator guide.
Choosing a type
| If you want to… | Use |
|---|---|
| Attach contacts without spending credits | none |
| Get verified emails as cheaply as possible | partial (default) |
| Pull personal phone numbers for cold calling | phone_only |
| Maximize coverage on every contact | full |
| Find new people at target companies | prospecting_only |
Combining with smart columns
After an enrichment finishes, you can layer Smart Columns on top of the resulting contacts inside the portal — for example, add email_validation for an extra deliverability check, enrich_company for a company background, or cold_intro_email for an AI-generated outreach draft. Smart Columns are run from the portal but consume from the same credit pool.
Related
- Enrichment endpoint — submit a bulk request
- Credits — credit costs
- Waterfall enrichment — how Cleanlist combines providers
- Smart Columns — AI-driven post-enrichment processing