Data Legion · Person enrichment (base-with-contact)
datalegion/people/enrich-base-with-contactFind companies, people and contact details with Data Legion · Person enrichment (base-with-contact) from Alexandria through one Spiral API key. Match a known person using identifiers with the base-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.
Pricing
Up to $0.087295 per run.
Limits
- Runs
- In the background
- Returns
- json
- 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 | 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. |
Same request in code
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-base-with-contact",
"input": {
"city": "<city>"
}
}'Frequently asked questions
How much does Data Legion · Person enrichment (base-with-contact) cost?
Up to $0.087295 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 (base-with-contact) through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "datalegion/people/enrich-base-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 (base-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 (base-with-contact)?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.