# Data Legion Person Premium Enrichment

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

Enriches a person profile with premium-grade data by matching on identifiers like email, phone, LinkedIn URL, or name+context fields.

## Facts

- Endpoint: POST https://agents.datalegion.ai/person/premium
- Price: $0.08/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-premium-enrichment-b5925af4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3424P0rZ1GAdqvuoV2OWJ

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-premium-enrichment-b5925af4 -d '<json body>'
```

Example prompt: Can you pull up the premium Data Legion person profile for sarah.chen@acme.com — I need her current job title, company, and LinkedIn URL, and only return results with at least moderate confidence?

## When to prefer this

Use this endpoint when you need premium-quality person enrichment with confidence scoring, field filtering, and support for diverse input identifiers including hashed emails, LinkedIn IDs, and legion_id stable references. Prefer this over basic lookup services when accuracy, confidence levels, and per-call pay-as-you-go pricing matter, particularly for autonomous agent workflows enriching CRM leads or verifying identity signals.

## Known failure modes

- No match found for the provided identifiers — returns empty result or 404
- Insufficient identifying information provided — requires at least one resolvable identifier
- Confidence threshold too high — valid matches exist but are filtered out by min_confidence setting
- Invalid email format or phone number format — returns validation error
- Rate limit exceeded or payment failure — returns 402 or 429 error
- Requested fields not available for matched person — partial result returned

## 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 an enriched person record including fields such as full name, email, phone, job title, company, social profile URLs, location details, birth date, and a Data Legion stable ID (legion_id), filtered to the requested confidence level and field allowlist.

## 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-premium-enrichment-b5925af4/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)