# Data Legion Company Premium Enrichment

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

Enriches a company profile with premium data using name, domain, ticker, LinkedIn ID, or social URL as lookup keys, returning structured company intelligence with configurable field control and confidence filtering.

## Facts

- Endpoint: POST https://agents.datalegion.ai/company/premium
- Price: $0.04/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-company-premium-enrichment-74967784
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4qXi5zekQyay03wYi-csg

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

Example prompt: Pull the premium Data Legion company profile for Stripe — their domain is stripe.com — and only return high-confidence matches with the company name, industry, and employee count fields.

## When to prefer this

Use this endpoint when you need premium, high-coverage company enrichment and can supply at least one strong identifier such as a domain, ticker symbol, LinkedIn ID, or social URL. Prefer this over basic lookup endpoints when you need field-level control (include/exclude fields), confidence filtering, or multiple candidate matches for fuzzy company names.

## Known failure modes

- No match found for the provided identifiers — returns empty or low-confidence result
- Ambiguous company name with no industry hint — may return wrong company or require multiple_results
- min_confidence set to 'high' filters out all candidates — returns no results
- Invalid or unrecognized ticker symbol or LinkedIn ID — lookup fails
- limit parameter ignored if multiple_results is false
- Conflicting identifiers (e.g. domain and name mismatch) may reduce match confidence

## How this service works

POST /company/premium — company enrichment, premium tier, no PII. Body: at least one of legion_id | domain | name | linkedin_id | social_url | ticker_symbol. Optional refinement: industry. Optional: min_confidence, multiple_results, limit, titlecase, required_fields, include_fields, exclude_fields, pretty_print. anonymous (each rail authenticates via its own payment credential). $0.04/call; zero-settle on no-match.

## Output

Returns a structured company record (or multiple ranked matches if multiple_results is set) with firmographic fields such as industry, size, location, and social profiles. Fields can be filtered via include_fields or exclude_fields. Results are filtered by min_confidence and required_fields constraints. Confidence and match metadata are included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Company name."
  },
  "limit": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1,
   "description": "Max matches when multiple_results is set."
  },
  "domain": {
   "type": "string",
   "description": "Company web domain."
  },
  "industry": {
   "type": "string",
   "description": "Industry, used to refine an ambiguous company match."
  },
  "legion_id": {
   "type": "string",
   "description": "Data Legion stable identifier."
  },
  "titlecase": {
   "type": "boolean"
  },
  "social_url": {
   "type": "string",
   "description": "Public social profile URL (e.g. a LinkedIn profile)."
  },
  "linkedin_id": {
   "type": "string",
   "description": "LinkedIn numeric member/company ID."
  },
  "pretty_print": {
   "type": "boolean"
  },
  "ticker_symbol": {
   "type": "string",
   "description": "Stock ticker symbol."
  },
  "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 present in a match."
  },
  "multiple_results": {
   "type": "boolean",
   "description": "Return multiple matches instead of the single best."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "acme inc",
  "size": "1001-5000",
  "domain": "acme.com",
  "industry": "technology",
  "legion_id": "c8a1b2c3-d4e5-6f7a-8b9c-0d1e2f3a4b5c"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/data-legion-company-premium-enrichment-74967784/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)