---
title: "Enrich a company"
method: POST
path: "/v1/companies/{id}/enrich"
tags: ["Companies"]
---

# Enrich a company

`POST /v1/companies/{id}/enrich`

## Request

- Base URL: `https://api.metal.ai`
- URL: `https://api.metal.ai/v1/companies/{id}/enrich`
- Auth: API key in header `x-metal-client-id` and API key in header `x-metal-api-key`
- TypeScript: <https://skmtc.dev/metal/apis/metal-api/docs/v1/companies/:id/enrich/post.ts> (a function with typed inputs; its response is checked against the schema)

Triggers asynchronous enrichment for a company. Metal gathers candidate values from your documents, data providers, and the web, then ranks and reconciles them into a single value per attribute. Enriched values appear on the record once processing completes; poll the company to read them, and inspect the `enrichment` field for the discovered values and citations behind each attribute. See the Enrichment and Reconciliation & ranking guides.

## Path parameters

- `id` string, required

## Response `200`

Enrichment was accepted.

- object
  - `data` object
    - `id` string: The company id.
    - `status` string: Enrichment status, e.g. "started".

## Other responses

- `401`: Missing or invalid API key credentials.
- `404`: The resource does not exist in your organization.

---

[API](https://skmtc.dev/metal/apis/metal-api.md) - [All operations](https://skmtc.dev/metal/apis/metal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metal/apis/metal-api/revisions/afb7b675d5b2?raw)