# Person Enrichment API (x402)

> Person Enrichment API (x402) is a paid API for AI agents from x402.freeq.one, paid per call via x402, $0.06/call, status unknown (last checked 2026-10-26).

Enrich a person's professional profile and work email by LinkedIn URL or full name plus company, returning verified email variants, headline, role history, education, skills, and location.

## Facts

- Endpoint: POST https://x402.freeq.one/tools/enrich_person?utm_source=zero.xyz
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-26
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/person-enrichment-api-x402-870ea82b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gkFfmsyE_C2EKPykN9P6t

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability person-enrichment-api-x402-870ea82b -d '<json body>'
```

Example prompt: Can you find the work email and full professional profile for Patrick Collison at Stripe — his LinkedIn is linkedin.com/in/patrickcollison?

## When to prefer this

Choose this endpoint when you need to enrich a specific individual's professional profile or discover their work email, especially when you have a LinkedIn URL or a name+company combination. It is well-suited for sales prospecting, CRM enrichment, and pre-meeting research. Prefer it over generic web search when you need structured, verified output (email verification status, role history) rather than raw text. Note: phone and personal email lookups are not available; use a different provider for those.

## Known failure modes

- 404 returned when no match is found after settlement (not charged)
- Status 'pending' returned when lookup is still processing — caller should retry
- 400 returned if want_phone or want_personal_email is set to true (unsupported)
- Ambiguous name+company combinations may yield wrong person or no result
- Profile data may be incomplete if the person has limited public presence
- Payment failure via x402 if wallet has insufficient USDC on Base

## How this service works

Person Enrichment: Enrich one person by professional-profile URL, or by full name plus company domain or company name. Returns the work email (verification status plus all variants found) and the full public profile: headline, current role, experience history, education, skills, location. Unfinished lookups return status "pending"; a settled no-match returns 404 and is not charged. Pay per call in USDC on Base via x402 — POST https://x402.freeq.one/tools/enrich_person.

## Output

A JSON object containing: work email address(es) with verification status and all discovered variants; full public professional profile including headline, current role and company, full experience history, education, skills list, and location. Unfinished lookups return status 'pending'. If no match is found after processing, a 404 is returned and the call is not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "full_name": {
   "type": "string",
   "example": "Patrick Collison",
   "description": "Person's full name. Required unless profile_url is supplied; the email search also needs a company key."
  },
  "want_email": {
   "type": "boolean",
   "example": true,
   "description": "Request the work email (default true). Needs full_name plus company_domain or company_name."
  },
  "want_phone": {
   "type": "boolean",
   "example": false,
   "description": "Must stay false — phone lookup is not available and returns a 400."
  },
  "profile_url": {
   "type": "string",
   "example": "https://www.linkedin.com/in/patrickcollison",
   "description": "Professional-profile URL (e.g. LinkedIn) — the richest key; alone it yields a profile without an email."
  },
  "company_name": {
   "type": "string",
   "example": "Stripe",
   "description": "Company name — alternative to company_domain for the email search."
  },
  "company_domain": {
   "type": "string",
   "example": "stripe.com",
   "description": "Company domain, e.g. stripe.com — disambiguates the email search."
  },
  "want_personal_email": {
   "type": "boolean",
   "example": false,
   "description": "Must stay false — personal-email lookup is not available and returns a 400."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "content": [],
  "isError": false,
  "structuredContent": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/person-enrichment-api-x402-870ea82b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.freeq.one](https://www.zero.xyz/host/x402.freeq.one/llms.txt)