---
title: "Search companies"
url: https://docs.gleap.ai/en/reference/rest-api/search
method: GET
path: "/companies/search"
api: "API Reference"
tag: "Company"
operationId: "Search"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# Search companies

`GET https://api.gleap.io/v3/companies/search`

Free-text company search for the dashboard's global search, backed by OpenSearch. Matches an exact `companyId` or `domain`, then the company name (whole words, prefix, and a fuzzy fallback), ranked by relevance and capped at 25 hits. Use GET /companies for paginated browsing and filtering.

Declared before GET /companies/{companyId} on purpose — tsoa registers routes in declaration order, so the reverse would make `/companies/search` resolve as a company whose id is literally "search".

## Authorization

- `Authorization` (header, required): `Bearer <token>`

## Headers

- `project` (string, required)

## Example request

```bash
curl --request GET \
  --url https://api.gleap.io/v3/companies/search \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>'
```

## Responses

### 200 (`application/json`)

Ok

- `id` (string, required)
- `companyId` (string)
- `name` (string)
- `domain` (string)
- `plan` (string)
- `value` (number<double>)
- `lastSeenAt` (string)

```json
[
  {
    "id": "string",
    "companyId": "string",
    "name": "string",
    "domain": "string",
    "plan": "string",
    "value": 0,
    "lastSeenAt": "string"
  }
]
```