---
title: "Get Company List"
method: GET
path: "/v0/company_lists/{list_id}"
tags: ["Company Lists"]
---

# Get Company List

`GET /v0/company_lists/{list_id}`

## Request

- Base URL: `https://api.theirstack.com`
- URL: `https://api.theirstack.com/v0/company_lists/{list_id}`
- Auth: HTTP bearer

Get one of the team's company lists by ID: its name, owner, type, creation date and number of companies. The companies themselves are not included.

## Path parameters

- `list_id` integer, required

## Response `200`

Successful Response

- CompanyList
  - `name` string, required: Name of the company list
  - `id` integer, required
  - `created_at` string, date-time, required
  - `deletable` boolean, nullable: Whether the list can be deleted
  - `companies_count` integer: Number of companies in the list
  - `user_id` integer, nullable: User ID of the list owner
  - `type` 'REVEALED_COMPANIES' | 'WEBHOOK_TRIGGERED' | 'MANUAL_CREATION' | 'EXPORT_SNAPSHOT' | 'INTERNAL_WEBHOOK_TRIGGERED' | 'CUSTOMER_CRM_SYNC'
  - `webhook_id` integer, nullable: Webhook ID of the list
  - `customer_crm_connection_id` integer, nullable: CRM connection that keeps this list in sync (CUSTOMER_CRM_SYNC lists)

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `422`: Unprocessable Content
- `500`: Internal Server Error

## Changes

- **2026-10-20** `419602bcfbf6`: 1 warning, 1 info
  - added the new `CUSTOMER_CRM_SYNC` enum value to the `type/anyOf[subschema #1: CompanyListType]/` response property for the response status `200`
  - added the optional property `customer_crm_connection_id` to the response with the `200` status
- **2026-10-14** `acc7d199f39a`: 1 warning
  - added the new `INTERNAL_WEBHOOK_TRIGGERED` enum value to the `type/anyOf[subschema #1: CompanyListType]/` response property for the response status `200`
- **2026-05-10** `1dae359ce2c7`: 1 warning
  - added the new `EXPORT_SNAPSHOT` enum value to the `type/anyOf[subschema #1: CompanyListType]/` response property for the response status `200`
- **2026-01-14** `ecd1eb029865`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/theirstack/apis/theirstack-api-reference/changes/v0/company_lists/:list_id/get.md)

---

[API](https://skmtc.dev/theirstack/apis/theirstack-api-reference.md) - [All operations](https://skmtc.dev/theirstack/apis/theirstack-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/theirstack/apis/theirstack-api-reference/revisions/4f3da5ce4026?raw)