---
title: "Searches through all companies known to Black Kite, across all customers."
method: POST
path: "/api/v2/global-company-searches"
tags: ["Global Companies"]
---

# Searches through all companies known to Black Kite, across all customers.

`POST /api/v2/global-company-searches`

Create a global (cross-tenant) search operation for companies. Unlike the companies/search operation, this searches the entire Black Kite company catalog, not just the requesting customer's portfolio. This endpoint will not return the list of resulting companies, but instead it will return a search key, that can be used to list the companies found by using the getGlobalCompanies operation. At least one of CompanyName, Domain, CountryCodes, IndustryCodes or Statuses must be provided. 
 **Attention:** Every unique client id can create a maximum of 100000 search key per day.

## Request body

- object
  - `CompanyName` string, nullable — The name (or part of the name) of the company to search for.
  - `Domain` string, nullable — The main domain value of the company to search for.
  - `CountryCodes` string[], nullable — The list of countries that the companies belong to in two letters format.
  - `IndustryCodes` number[], nullable — The list of industry codes that the companies are classified with.
  - `Statuses` string[], nullable — The list of statuses of the company relative to the requesting customer's account.

## Response `200`

Success

- object
  - `Key` string, required — A key in GUID format, which points to the newly created global company search action. Use this key in the getGlobalCompanies operation as a query parameter in order to fetch the results. The key has a life time of 6 hours. A new search operation should be performed when the search keys are expired.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `500` — InternalServerError

## Changes

- **2026-09-04** `d80d95cf2197` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/blackkitetech/apis/black-kite-api/changes/api/v2/global-company-searches/post.md)

---

[API](https://skmtc.dev/blackkitetech/apis/black-kite-api.md) · [All operations](https://skmtc.dev/blackkitetech/apis/black-kite-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blackkitetech/apis/black-kite-api/revisions/f1e937bdbbbd?raw)