---
title: "Enrich companies"
method: POST
path: "/v2/enrich/companies"
tags: ["Enrich"]
---

# Enrich companies

`POST /v2/enrich/companies`

Match companies with our database and enrich it with additional information.


**Webhook result:**
[Documentation](/docs/webhooks/enrich_companies)

## Query parameters

- `apiToken` string, nullable

## Headers

- `x-api-token` string, nullable

## Request body

- MatchCompaniesBody
  - `companyDataMapping` object, required — A dictionary where each key is unique user-defined ID for a company, and each value is the data for that company to be enriched. This ID will be included in the webhook response together with the enriched company data, allowing the user to match the response to the original request.
  - `webhookUrl` string, required — Url of the webhook the enriched companies should be sent to, when completed.
  - `fields` CompanyField[], nullable — Fields to return in the Company objects. Only requesting the fields that are needed will use less bandwidth and result in faster responses. If not specified, all fields are returned that can be seen in the example.

## Response `200`

Successful Response

- EnrichCompaniesResult
  - `status` 'in progress', required — Status of the enrichment request. Always `"in progress"` initially, as enrichment is processed asynchronously in the background. Once completed, results for all companies will be sent to the provided webhook.

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/ocean/apis/ocean-io-api-documentation.md) · [All operations](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ocean/ocean-io-api-documentation/revisions/a5d5c0530873/schema)