---
title: "Autocomplete companies"
method: POST
path: "/v2/autocomplete/companies"
tags: ["Autocomplete"]
---

# Autocomplete companies

`POST /v2/autocomplete/companies`

Auto complete the name search

## Query parameters

- `apiToken` string, nullable

## Headers

- `x-api-token` string, nullable

## Request body

- ModelsAutocompleteCompaniesAutoCompletionBody
  - `name` string, required — Beginning of the name or the domain of a company
  - `countryFilters` string[], nullable — List of countries to filter for the autocompletion
  - `excludeDomains` string[], nullable — List of domains to exclude from the results
  - `forLookalikeSearch` boolean — When `false`, returns all matching companies without domain validation or status filters. WARNING: Do not set this parameter to `false` if the autocomplete results will be used as input for a lookalike search.

## Response `200`

Successful Response

- ModelsAutocompleteCompaniesAutoCompletionResult
  - `companies` AutoCompletionCompany[], required — Array of found companies. Returns empty array if no results
    - `domain` string, required — Domain of the company, used as a unique identifier
    - `logo` string, nullable — Logo of the company (URL)
    - `name` string, nullable — Name of the company

## Other responses

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

---

[API](https://skmtc.net/ocean/apis/ocean-io-api-documentation.md) · [All operations](https://skmtc.net/ocean/apis/ocean-io-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ocean/ocean-io-api-documentation/versions/0f900a1e318f/schema)