POST /v1/enrich answers: what else is known about this person or company? Send the identifiers you have and get back the missing fields. Every field carries a level (how sure Agentic ID is) and the source it came from. Use it when you have a record and need more on it. To find new people, use Find or Discover.
200
Contact values are returned masked today. An email keeps its first character and its domain (
a******@acme.example), a phone keeps its last four digits (+*******0123), and a profile link keeps the first two characters of its handle.Request
Send at least one ofcontact, contacts or company.
Return only these fields. Applies to every record in the request; a name that does not exist for a record’s kind is ignored.
- Person fields:
work_email,linkedin_url,title,seniority,company_name,company_domain,country,city,mobile_phone. - Company fields:
name,domain,industry,employees,country,description. - Accepted aliases:
email(work_email),job_title(title),company(company_name),linkedin(linkedin_url),phoneandmobile(mobile_phone).
work_email, linkedin_url, title, seniority, company_name, company_domain and country; a company gets all six company fields. mobile_phone and city are returned only when asked for.Why you are asking. One of
b2b_outbound, ad_audience, own_customer_enrichment, fraud_check. The call is refused if your workspace has not allowed the purpose.Response
What it costs
- The charge is per record, not per field.
quoted_creditsis 2 per person plus 1 for the company, ormax_creditsif that is lower. It is never below what was charged.max_creditsis required. A record whose price does not fit under what is left is returned with no fields and is not charged.- If your balance covers only part of the request, the part it covers is delivered.
Errors
See Errors for the full list.
Behaviour
- Batch limit. Up to 100 people in
contacts, plus one incontact, plus onecompany, in one call. - Match results by position. Results carry no row key. They come back in request order.
- Only values that pass are delivered. A value with a single source is delivered as
claimed. An unverified email, phone or profile link is held back, and the record’s status isheld. - Phones cost more.
mobile_phoneis returned only when you ask for it infields. - The CLI enriches one person per call. Use the API or SDK for batches and for companies.

