---
title: List All Lists
description: Retrieve all company lists for the current team including list name, company count, and creation date. Use company lists to organize and segment companies for targeted outreach and analysis.
url: https://theirstack.com/en/docs/api-reference/company-lists/get_company_lists_v0
---

## GET /v0/company\_lists — List All Lists

Retrieve all company lists for the current team including list name, company count, and creation date. Use company lists to organize and segment companies for targeted outreach and analysis.

### Responses

#### 200 — Successful Response

#### 400 — Bad Request

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | Error | Yes |  |
| `request_id` | integer | No | The request id. This is useful to contact us to help you debug the issue. The request\_id won't be present in all errors. |

##### `error`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | No | The error code. Eg: \`E-001\`, \`E-002\`, \`E-003\`, \`E-004\`, \`E-005\`, \`E-006\`, \`E-007\`, \`E-008\`, \`E-009\`, \`E-010\`, \`E-011\`, \`E-012\`, \`E-013\`, \`E-014\`, \`E-015\`, \`E-016\` |
| `description` | string | No | The error description |
| `title` | string | Yes | The error title. |

#### 402 — Payment Required

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | Error | Yes |  |
| `request_id` | integer | No | The request id. This is useful to contact us to help you debug the issue. The request\_id won't be present in all errors. |

##### `error`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | No | The error code. Eg: \`E-001\`, \`E-002\`, \`E-003\`, \`E-004\`, \`E-005\`, \`E-006\`, \`E-007\`, \`E-008\`, \`E-009\`, \`E-010\`, \`E-011\`, \`E-012\`, \`E-013\`, \`E-014\`, \`E-015\`, \`E-016\` |
| `description` | string | No | The error description |
| `title` | string | Yes | The error title. |

#### 422 — Unprocessable Entity

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | Error | Yes |  |
| `request_id` | integer | No | The request id. This is useful to contact us to help you debug the issue. The request\_id won't be present in all errors. |

##### `error`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | No | The error code. Eg: \`E-001\`, \`E-002\`, \`E-003\`, \`E-004\`, \`E-005\`, \`E-006\`, \`E-007\`, \`E-008\`, \`E-009\`, \`E-010\`, \`E-011\`, \`E-012\`, \`E-013\`, \`E-014\`, \`E-015\`, \`E-016\` |
| `description` | string | No | The error description |
| `title` | string | Yes | The error title. |

#### 500 — Internal Server Error

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | Error | Yes |  |
| `request_id` | integer | No | The request id. This is useful to contact us to help you debug the issue. The request\_id won't be present in all errors. |

##### `error`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | No | The error code. Eg: \`E-001\`, \`E-002\`, \`E-003\`, \`E-004\`, \`E-005\`, \`E-006\`, \`E-007\`, \`E-008\`, \`E-009\`, \`E-010\`, \`E-011\`, \`E-012\`, \`E-013\`, \`E-014\`, \`E-015\`, \`E-016\` |
| `description` | string | No | The error description |
| `title` | string | Yes | The error title. |