Skip to main content
Enrichment fills in what your firm doesn’t already know. Metal combines AI with data providers to populate attributes — firmographics, financials, headcount, signals — on the resources you track.

​
How enrichment works

When you enrich a company, Metal gathers data from multiple sources, resolves conflicts, 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.

​
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.