Skip to main content
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 of contact, contacts or company.
object
One person. Same fields as each entry of contacts.
object[]
Up to 100 people. Every field is optional; send what you have.
object
One company.
string[]
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), phone and mobile (mobile_phone).
When omitted, a person gets 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.
string
default:"b2b_outbound"
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.
integer
required
The most this call may charge. 0 to 100000. Never charged past it.

Response

string
required
The ID of this call. The same value as the X-Request-Id header.
string
required
One plain sentence: how many records were enriched and what was charged.
object
required
object[]
required
One entry per record, in request order: contact first, then contacts, then company.

What it costs

  • The charge is per record, not per field.
  • quoted_credits is 2 per person plus 1 for the company, or max_credits if that is lower. It is never below what was charged.
  • max_credits is 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.
See Credits for how holds and charges work.

Errors

See Errors for the full list.

Behaviour

  • Batch limit. Up to 100 people in contacts, plus one in contact, plus one company, 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 is held.
  • Phones cost more. mobile_phone is returned only when you ask for it in fields.
  • The CLI enriches one person per call. Use the API or SDK for batches and for companies.