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

# List companies

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

List a project's companies, most recently seen first. Paginated via `skip` (default 0) and `limit` (default 50, maximum 200); `search` filters by a case-insensitive substring match on the company name. Returns a summary of each company (`companyId`, `name`, `plan`, `value`, `domain`, `lastSeenAt`, `createdAt`); use GET /companies/{companyId} for the full record.

## Authorization

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

## Headers

- `project` (string, required)

## Example request

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

## Responses

### 200 (`application/json`)

Ok

- `_id` (string, required)
- `companyId` (string, required)
- `name` (string)
- `plan` (string)
- `domain` (string)
- `value` (number<double>)
- `sla` (number<double>)
- `tags` (string[])
- `address` (object): Request and response shapes of the companies API. They exist for the OpenAPI spec (the docs playground renders a body form from it); the service still whitelists and coerces every field itself (normalizeCompanyPayload).
  - `line1` (string)
  - `line2` (string)
  - `city` (string)
  - `state` (string)
  - `postalCode` (string)
  - `country` (string)
- `customData` (object)
- `owner` (string)
- `ownerEmail` (string)
- `nameIsAuthoritative` (boolean)
- `lastSeenAt` (string)
- `createdAt` (string)
- `updatedAt` (string)

```json
[
  {
    "_id": "string",
    "companyId": "string",
    "name": "string",
    "plan": "string",
    "domain": "string",
    "value": 0,
    "sla": 0,
    "tags": [
      "string"
    ],
    "address": {
      "line1": "string",
      "line2": "string",
      "city": "string",
      "state": "string",
      "postalCode": "string",
      "country": "string"
    },
    "customData": {},
    "owner": "string",
    "ownerEmail": "string",
    "nameIsAuthoritative": true,
    "lastSeenAt": "string",
    "createdAt": "string",
    "updatedAt": "string"
  }
]
```