Skip to main content
Enrichment fills in what your firm doesn’t already know. Metal combines AI with data providers and your own documents to populate attributes such as firmographics, financial metrics, headcount, and signals on the resources you track. Every enriched attribute keeps its provenance. Metal collects candidate values from many sources, ranks and reconciles them into a single best value, and shows you the citation behind each one.

​
How enrichment works

When you enrich a company, Metal gathers data from multiple sources, ranks and reconciles conflicting values, and writes the result back to the record. Enrichment runs asynchronously: you trigger it, and the enriched values appear on the record once processing completes.
1

Trigger enrichment

Call the enrich endpoint for a company.
curl -X POST https://api.metal.ai/v1/companies/665f1c2a9b1e4a0012a3b4c5/enrich \
  -H "x-metal-client-id: $METAL_CLIENT_ID" \
  -H "x-metal-api-key: $METAL_API_KEY"
2

Metal sources and resolves data

Metal queries providers and AI models, then reconciles the results into a single best value per attribute.
3

Read the enriched record

Fetch the company again to read the enriched fields, such as sector, description, financials, and timestamps like lastEnrichedAt.
Enrichment is asynchronous. After triggering it, poll the company record (or wait for a webhook if configured) rather than expecting enriched values in the immediate response.

​
Discovered values and citations

For each attribute, Metal keeps every value it has discovered — not just the one it displays. Each discovered value carries its source, a confidence score, and when it was found, so you can always trace a value back to where it came from. Metal reconciles and ranks these candidates into a single displayed value. You can override the choice by pinning a specific value, which takes precedence over future enrichment until you unpin it.
The Subsector popover with a value pinned, showing its source and confidence and an Unpin value button

​
Sources and what gets enriched

An admin controls which attributes Metal enriches and which sources it draws from under Settings → Enrichment. Sources are prioritized — Metal prefers higher-priority connections when it reconciles conflicting values.
The Enrichment settings page listing company properties such as Last Valuation, Last Amount Raised, and Last Financials, with source connections for Third Party Data, Web Search, and Platform Data
Beyond third-party data and web search, Metal extracts values from your own documents — CIMs, financial statements, board decks, and more. An admin chooses which document types to extract from and can add instructions to guide each extraction under Settings → Extraction.
The Extraction settings page listing document types like 10K, CIM, Financial Statement, and Quality of Earnings, each with an enable toggle
The CIM document type expanded to show an Extraction instructions field with Enhance and Generate from example options

​
Enrichment timestamps

Companies carry timestamps that tell you the state of enrichment:
FieldDescription
lastEnrichmentStartedAtWhen the most recent enrichment run began.
lastEnrichedAtWhen enrichment last completed and wrote values.
If lastEnrichmentStartedAt is newer than lastEnrichedAt, a run is in progress.

​
Enriching in bulk

To enrich many resources at once, add them to a list and trigger enrichment at the list level. Lists are the spreadsheet-like surface for working with resources in bulk, including computing enriched columns across every entry.

​
Best practices

Create first, enrich second

Create a company with at least a canonicalName (and a website when you have one) before enriching for the best match.

Poll, don't block

Trigger enrichment and check back later; don’t hold a request open waiting for results.

Provide hints

The more identifying detail you supply (website, location), the more accurate enrichment is.

Batch with lists

Use lists to enrich large sets efficiently instead of looping one-by-one.