---
title: "List company lists"
method: GET
path: "/api/v2/supersearch-enrichment/company-lists"
tags: ["CompanyList"]
---

# List company lists

`GET /api/v2/supersearch-enrichment/company-lists`

## Request

- Base URL: `https://api.instantly.ai`
- URL: `https://api.instantly.ai/api/v2/supersearch-enrichment/company-lists`
- Auth: HTTP bearer

Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`

## Query parameters

- `limit` integer
- `starting_after` string
- `cursor` string
- `search` string

## Response `200`

Default Response

- object
  - `data` object[], required
    - `company_list_id` string, uuid, required
    - `name` string, required
    - `provider_id` string, required
    - `company_source_id` string, required
    - `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required
    - `terminal_reason` 'MAX_COMPANIES_REACHED' | 'PROVIDER_EXHAUSTED' | 'NO_RESULTS' | 'PROVIDER_ERROR' | 'INTERNAL_ERROR' | 'OUT_OF_CREDITS' | 'UPLOAD_ABORTED'
    - `requested_count` integer, required
    - `company_count` integer, required
    - `saved_count` integer
    - `credits_charged` integer
    - `filters` object: Filters the list was built with, keyed by filter key. Since INS-9685 an entry of a filter backed by a remote catalog — `company_technology_slug_or`, `industry_or` — is returned as `{ value, label }` instead of a plain string, so a saved list can render the human name without a provider call. Entries stored before that change are still returned as plain strings, and both forms are accepted on create.
    - `timestamp_created` string, date-time, required
    - `timestamp_updated` string, date-time, required
  - `next_starting_after` string
  - `next_cursor` string: Deprecated alias of `next_starting_after`, always identical to it.
  - `total` integer: Number of lists matching the request, counted exactly up to 10000. A workspace with more matches than that reports 10000.

## Other responses

- `401`: This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402`: This request cannot be fulfilled because the workspace does not have an active paid plan
- `404`: The requested resource was not found
- `429`: You have exceeded the rate limit. Please check the rate limit docs for more information.

## Changes

- **2026-11-03** `c781051105a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/instantly/apis/api-explorer/changes/api/v2/supersearch-enrichment/company-lists/get.md)

---

[API](https://skmtc.dev/instantly/apis/api-explorer.md) - [All operations](https://skmtc.dev/instantly/apis/api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/instantly/apis/api-explorer/revisions/bea714781ea4?raw)