---
title: "Get a company"
url: https://docs.gleap.ai/en/reference/rest-api/detail
method: GET
path: "/companies/{companyId}"
api: "API Reference"
tag: "Company"
operationId: "Detail"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# Get a company

`GET https://api.gleap.io/v3/companies/{companyId}`

Get one company by its external `companyId`, the identifier your app sends via the SDK, not the Gleap `_id`.

## Authorization

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

## Path parameters

- `companyId` (string, required)

## Headers

- `project` (string, required)

## Example request

```bash
curl --request GET \
  --url 'https://api.gleap.io/v3/companies/{companyId}' \
  --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"
}
```