# Data Legion · Person enrichment (premium-with-contact)

Find companies, people and contact details with Data Legion · Person enrichment (premium-with-contact) from Alexandria through one Spiral API key. Match a known person using identifiers with the premium-with-contact product. Contact entitlement comes from the dedicated credential, never from field projection. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Lead Gen
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `datalegion/people/enrich-premium-with-contact`
- Page: https://spiral.ai/tools/alexandria/datalegion/people/enrich-premium-with-contact

## Pricing

Up to $0.139672 per run.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `city` | text |  | — | City name |
| `email` | text |  | — | Email address (will be normalized) |
| `phone` | text |  | — | Phone number (will be normalized to E.164) |
| `state` | text |  | — | State name or code |
| `school` | text |  | — | School name, website, or social URL |
| `address` | text |  | — | Full address string (will be parsed to extract city, state, postal_code, and country) |
| `company` | text |  | — | Company name, website, or social URL |
| `country` | text |  | — | Country name or code |
| `full_name` | text |  | — | Full name (will be normalized) |
| `job_title` | text |  | — | Job title |
| `last_name` | text |  | — | Last name (will be normalized) |
| `legion_id` | text |  | — | Legion ID (exact match) |
| `titlecase` | true or false |  | false | If true, format text fields in title case (names, job titles, company names, locations, skills, headlines). Raw fields, IDs, URLs, codes, and confidence fields are excluded. |
| `birth_date` | text |  | — | Birth date for matching or narrowing name-based results (YYYY-MM-DD, YYYY-MM, or YYYY). Can be used as name + birth_date lookup or as a qualifier on other name-based combos. |
| `email_hash` | text |  | — | SHA-256 (64 chars), SHA-1 (40 chars), or MD5 (32 chars) hash of normalized email address (for privacy) |
| `first_name` | text |  | — | First name (will be normalized) |
| `social_url` | text |  | — | Social profile URL (LinkedIn, Twitter/X, GitHub, Facebook - will be normalized and detected) |
| `linkedin_id` | text |  | — | LinkedIn numeric ID |
| `postal_code` | text |  | — | Postal/ZIP code |
| `pretty_print` | true or false |  | false | If true, pretty-print JSON response with indentation. |
| `exclude_fields` | text |  | — | Comma-separated list of fields to exclude from response. Applied after include_fields filter. |
| `include_fields` | text |  | — | Comma-separated list of fields to include in response. If omitted, all fields are returned. |
| `min_confidence` | one of | high, moderate, low | — | Minimum match confidence level to include in results: 'high', 'moderate', or 'low'. Matches below this threshold will be filtered out. |
| `required_fields` | text |  | — | Comma-separated list of fields that must be present, else the match is filtered out. Supports top-level fields ('work_email,phones'), a non-empty list subfield ('emails.type'), or a subfield equal to a value ('emails.type:personal', 'phones.type:mobile', 'socials.network:linkedin'). Unknown field names or out-of-range enum values return HTTP 400. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "datalegion/people/enrich-premium-with-contact",
    "input": {
      "city": "<city>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=datalegion%2Fpeople%2Fenrich-premium-with-contact

## Common questions

### Data Legion · Person enrichment (premium-with-contact)

**How much does Data Legion · Person enrichment (premium-with-contact) cost?**

Up to $0.139672 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Data Legion · Person enrichment (premium-with-contact) through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "datalegion/people/enrich-premium-with-contact"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Data Legion · Person enrichment (premium-with-contact)?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Data Legion · Person enrichment (premium-with-contact)?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

