POST/api/v1/people/enrich

People Enrichment

Accepts an email address or a combination of first name, last name, and company domain, and returns a structured professional profile. Powered by ApiOne's proprietary AI layer, which synthesises signals from professional networks and public data sources to produce a single, high-confidence record.

Credit cost: 4 credits per successful call. 1 credit for a 404 not_found response.

Request

Headers

Header	Required	Value
`X-API-Key`	required	Your API key
`Content-Type`	required	`application/json`

Request body

You must provide either email alone, or all three of first_name, last_name, and domain.

Parameter	Type	Required	Description
`email`	string	optional*	Professional email address of the person
`first_name`	string	optional*	First name of the person
`last_name`	string	optional*	Last name of the person
`domain`	string	optional*	Company domain, e.g. `stripe.com`

* Either email or (first_name + last_name + domain) is required.

Example requests

By email

curl -X POST https://apione.store/api/v1/people/enrich \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

By name and domain

curl -X POST https://apione.store/api/v1/people/enrich \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "John", "last_name": "Smith", "domain": "stripe.com"}'

Response

Response fields

Field	Type	Description
`data.full_name`	string	Full name of the person
`data.email`	string	Professional email address
`data.title`	string	Current job title
`data.seniority`	string	`executive`, `senior`, `mid`, or `junior`
`data.department`	string	Department, e.g. `Engineering`, `Sales`, `Marketing`
`data.company_name`	string	Current employer name
`data.company_domain`	string	Current employer domain
`data.linkedin_url`	string	LinkedIn profile URL (if available)
`data.location`	string	City and country
`data.confidence`	float	AI confidence score from 0 to 1

Example response

{
  "status": "success",
  "request_id": "req_ppl123",
  "credits_used": 4,
  "data": {
    "full_name": "John Smith",
    "email": "[email protected]",
    "title": "Senior Software Engineer",
    "seniority": "senior",
    "department": "Engineering",
    "company_name": "Stripe",
    "company_domain": "stripe.com",
    "linkedin_url": "https://linkedin.com/in/johnsmith",
    "location": "San Francisco, CA, USA",
    "confidence": 0.91
  }
}

Error codes

HTTP status	Message	Cause
400	`missing_param`	Neither email nor name+domain provided
401	`invalid_api_key`	API key is missing or invalid
402	`insufficient_credits`	Account has no remaining credits
404	`not_found`	No profile found for the given input (1 credit deducted)
429	`rate_limit_exceeded`	Request rate exceeded for your plan

Code examples

Node.js

const response = await fetch('https://apione.store/api/v1/people/enrich', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.APIONE_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: '[email protected]' }),
});
const result = await response.json();
console.log(result.data.title); // "Senior Software Engineer"

Related endpoints

Email Finder — find a professional email from name + domain
People Search — search professionals by company or title
Guide: Recruiting enrichment workflow