---
title: "Get company by ID"
method: GET
path: "/companies/{company_id}"
tags: ["companies"]
---

# Get company by ID

`GET /companies/{company_id}`

## Request

- Base URL: `https://api.getpg.ai/public-api/v1`
- URL: `https://api.getpg.ai/public-api/v1/companies/{company_id}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/getpg/apis/pg-ai-public-api/docs/companies/:company_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve detailed information about a specific company. Requires "insights:read" permission.

## Path parameters

- `company_id` string, required

## Response `200`

Company found

- Company: Company information
  - `company_id` string, uuid, required
  - `company_name` string
  - `website_domain` string
  - `public_company` boolean
  - `country_code` string, nullable
  - `linkedin_url` string, nullable
  - `hq_city` string, nullable
  - `hq_state` string, nullable
  - `hq_address` string, nullable
  - `hq_postcode` string, nullable
  - `hq_country_name` string, nullable
  - `region` string, nullable
  - `ceo` string, nullable
  - `sector` string, nullable
  - `industry` string, nullable
  - `revenue_range` string, nullable
  - `employee_count_range` string, nullable
  - `full_time_employees` integer, nullable
  - `alternative_domains` string[], nullable
  - `alternative_names` string[], nullable
  - `tags` string[], nullable
  - `description` string, nullable
  - `stock_ticker` string, nullable
  - `market_cap` number, nullable
  - `stock_currency` string, nullable
  - `stock_exchange_name` string, nullable
  - `stock_exchange_symbol` string, nullable

## Other responses

- `400`: Bad request - Company ID is required
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - Insufficient permissions. Required: insights:read
- `404`: Company not found

---

[API](https://skmtc.dev/getpg/apis/pg-ai-public-api.md) - [All operations](https://skmtc.dev/getpg/apis/pg-ai-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpg/apis/pg-ai-public-api/revisions/cc47d013c073?raw)