---
title: "Research companies"
method: POST
path: "/companies/research"
tags: ["Company Research"]
---

# Research companies

`POST /companies/research`

Research companies by search result IDs from `/search/companies` and/or direct company identifiers (`domain`, `companyName`).

## Request body

- object
  - `searchResultIds` string[] — Company search result IDs returned from `/search/companies` that you want to enrich.
  - `companies` object[] — Companies to enrich directly without running search first. Each item must include at least one identifier: - `domain` - `companyName`
    - `domain` string — Company website domain used to identify the company.
    - `companyName` string — Company legal or common name used to identify the company.
  - `skipDeduplicationCheck` boolean — When true, research will not check for duplicate records that you already researched recently, and perform a research (which can result in credit usage)

## Response `202`

The request IDs for research

- object
  - `success` boolean — Indicates whether the request was accepted successfully.
  - `requestIds` string[] — Request identifiers for each submitted company research job.

## Other responses

- `401` — Unauthorized
- `422` — Insufficient credits or missing license
- `500` — Unexpected error

---

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