Enrich a person

Enrich a person with normalized fields (email, mobile, job title, company, LinkedIn URL, location, …). REQUIRES a identifiers object containing ONLY email and/or linkedin_url — these are the unique handles we use to resolve the person upstream. first_name, last_name, domain, company, etc. are NOT accepted here and will return a VALIDATION_ERROR. If you only have a name + company, call /people/email-finder first to obtain an email, then pass that email here. Optional fields[] narrows the waterfall to only fetch the fields you care about. agntdata runs a field-aware waterfall: it stops once all requested fields are filled or your max_cost_cents budget is exhausted.

POST /v1/data/agnt/people/enrich

Enrich a person

cURL

curl --request POST \
  --url https://api.agntdata.dev/v1/data/agnt/people/enrich \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifiers": {
    "linkedin_url": "https://linkedin.com/in/patrickcollison"
  },
  "fields": [
    "email",
    "job_title",
    "company_name",
    "company_domain"
  ]
}
'

200

{
  "success": true,
  "data": {
    "full_name": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "work_email": "<string>",
    "personal_email": "<string>",
    "verified_email": "<string>",
    "email_status": "<string>",
    "mobile": "<string>",
    "linkedin_url": "<string>",
    "twitter_url": "<string>",
    "job_title": "<string>",
    "seniority": "<string>",
    "department": "<string>",
    "company": {
      "name": "<string>",
      "domain": "<string>",
      "linkedin_url": "<string>"
    },
    "location": "<string>"
  },
  "meta": {
    "costCents": 123,
    "purchasedBalanceCents": 123,
    "subscriptionRemainingCents": 123,
    "cached": true,
    "latencyMs": 123,
    "priceRange": {
      "minCents": 123,
      "maxCents": 123
    },
    "budgetCents": 123,
    "budgetCentsPerRecord": 123,
    "providersAttempted": 123,
    "fieldsReturned": [
      "<string>"
    ],
    "fieldsMissing": [
      "<string>"
    ],
    "records": 123
  }
}

Authorizations

Authorization · string · header · required

Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_...

Body

application/json

identifiers · object · required

Unique handles used to resolve a person upstream. Provide AT LEAST ONE of email or linkedin_url. Name + company are NOT accepted here — for that flow, call /people/email-finder first to obtain an email.

Show child attributes

fields · enum<string>[]

Available options: email, work_email, personal_email, verified_email, mobile, linkedin_url, twitter_url, full_name, first_name, last_name, job_title, seniority, department, company_name, company_domain, location

max_cost_cents · number

Required range: x >= 0

Response

200

application/json

Person enrichment result.

success · enum<boolean> · required

Available options: true

data · object · required

Show child attributes

meta · object

Show child attributes