---
title: "Get companies by external ID"
method: GET
path: "/companies/by-external-id/{externalId}"
tags: ["companies"]
---

# Get companies by external ID

`GET /companies/by-external-id/{externalId}`

## Request

- Base URL: `https://productlane.com/api/v1`
- URL: `https://productlane.com/api/v1/companies/by-external-id/{externalId}`
- Auth: HTTP bearer

Get companies by an external ID. Returns all companies that have this external ID. Authentication is required.

## Path parameters

- `externalId` string, required

## Response `200`

Successful response

- object
  - `companies` object[], required
    - `id` string, uuid, required
    - `name` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `isDeleted` boolean, required
    - `version` number, required
    - `linearCustomerId` string, nullable, required
    - `size` number, nullable, required
    - `revenue` number, nullable, required
    - `statusId` string, nullable, required
    - `statusName` string, nullable, required
    - `statusColor` string, nullable, required
    - `tierId` string, nullable, required
    - `tierName` string, nullable, required
    - `logoUrl` string, nullable, required
    - `domains` string[], required
    - `autoAdd` boolean, nullable, required
    - `workspaceId` string, uuid, required
    - `intercomId` string, nullable, required
    - `hubspotId` string, nullable, required
    - `productboardId` string, nullable, required
    - `externalIds` string[], required
    - `slugId` string, nullable, required

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/productlane/apis/productlane-api.md) · [All operations](https://skmtc.dev/productlane/apis/productlane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/productlane/apis/productlane-api/revisions/9325a8425b36?raw)