# Data Legion Person Base Enrichment

> Data Legion Person Base Enrichment is a paid API for AI agents from agents.datalegion.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Looks up and returns structured profile data for a person given one or more identity signals such as email, name, phone, LinkedIn URL, or company context.

## Facts

- Endpoint: POST https://agents.datalegion.ai/person/base
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/data-legion-person-base-enrichment-b9d1ac8d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V3qMBrg45-daInv_4eAED

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 data-legion-person-base-enrichment-b9d1ac8d -d '<json body>'
```

Example prompt: Can you look up everything Data Legion knows about Jane Smith who works at Acme Corp and has the email jane.smith@acme.com — I need her phone, LinkedIn, job title, and location, with at least moderate confidence?

## When to prefer this

Use this endpoint when you need to enrich a single person record with structured profile data from a paid, high-coverage data provider. Prefer it over free enrichment tools when accuracy and breadth of data matter, or when you have a stable legion_id or LinkedIn identifier for precise resolution. Best suited for B2B lead enrichment, contact verification, and CRM augmentation workflows.

## Known failure modes

- No match found for the provided identity signals — returns empty or low-confidence result
- Insufficient input signals to disambiguate multiple candidates — returns top N matches up to limit
- Email or phone format invalid — validation error
- min_confidence threshold filters out all candidates — empty result
- Rate limit or payment failure (x402) — payment required error
- Ambiguous name with no context fields provided — low precision results

## How this service works

Per-call person + company enrichment for autonomous agents, powered by Data Legion. Pay per successful call over agent payment rails; no API key or account.

## Output

Returns a structured person profile including available fields such as full name, email, phone, current employer, job title, LinkedIn URL, location details, education, and a confidence score for the match. The response respects include_fields/exclude_fields filters and the requested min_confidence threshold.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string",
   "description": "City (person context)."
  },
  "email": {
   "type": "string",
   "description": "Email address."
  },
  "limit": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1,
   "description": "Max matches when multiple_results is set."
  },
  "phone": {
   "type": "string",
   "description": "Phone number (E.164 preferred)."
  },
  "state": {
   "type": "string",
   "description": "State or region (person context)."
  },
  "school": {
   "type": "string",
   "description": "School or university name (person context)."
  },
  "address": {
   "type": "string",
   "description": "Street address (person context)."
  },
  "company": {
   "type": "string",
   "description": "Current company name or domain (person context)."
  },
  "country": {
   "type": "string",
   "description": "Country (person context)."
  },
  "full_name": {
   "type": "string",
   "description": "Full name."
  },
  "job_title": {
   "type": "string",
   "description": "Job title (person context)."
  },
  "last_name": {
   "type": "string",
   "description": "Last name (pair with first_name + a context field)."
  },
  "legion_id": {
   "type": "string",
   "description": "Data Legion stable identifier."
  },
  "titlecase": {
   "type": "boolean"
  },
  "birth_date": {
   "type": "string",
   "description": "Birth date, YYYY-MM-DD (person context)."
  },
  "email_hash": {
   "type": "string",
   "description": "SHA-256 hash of a lowercased, trimmed email."
  },
  "first_name": {
   "type": "string",
   "description": "First name (pair with last_name + a context field)."
  },
  "social_url": {
   "type": "string",
   "description": "Public social profile URL (e.g. a LinkedIn profile)."
  },
  "linkedin_id": {
   "type": "string",
   "description": "LinkedIn numeric member/company ID."
  },
  "postal_code": {
   "type": "string",
   "description": "Postal / ZIP code (person context)."
  },
  "pretty_print": {
   "type": "boolean"
  },
  "exclude_fields": {
   "type": "string",
   "description": "Comma-separated fields to omit."
  },
  "include_fields": {
   "type": "string",
   "description": "Comma-separated allowlist of fields to return."
  },
  "min_confidence": {
   "enum": [
    "high",
    "moderate",
    "low"
   ],
   "type": "string",
   "description": "Minimum match confidence to return."
  },
  "required_fields": {
   "type": "string",
   "description": "Comma-separated field names that must be
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "city": "san francisco",
  "state": "ca",
  "full_name": "jane doe",
  "job_title": "product manager",
  "legion_id": "a6fd97f3-ded6-517f-b4fa-f6262776306a",
  "company_name": "acme"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/data-legion-person-base-enrichment-b9d1ac8d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.datalegion.ai](https://www.zero.xyz/host/agents.datalegion.ai/llms.txt)