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

# List company-list sources

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

## Request

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

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

## Response `200`

Default Response

- object[]
  - `provider_id` string, required
  - `provider_name` string, required
  - `logo_id` string, required
  - `company_source_id` string, required
  - `source_name` string, required
  - `credential_sources` string[], required
  - `credit_cost_per_saved_record` integer, required
  - `max_records_per_build` integer, required
  - `supports_preview` boolean, required
  - `connected` boolean
  - `filters` object[], required
    - `key` string, required
    - `label` string, required
    - `description_key` string
    - `type` 'text' | 'string_list' | 'domain_list' | 'number_list' | 'number' | 'boolean' | 'date' | 'range' | 'threshold' | 'select' | 'multiselect' | 'location', required
    - `required` boolean
    - `value_type` 'number' | 'date'
    - `max_values` integer
    - `min` number
    - `max` number
    - `options` object[]
      - `label` string, required
      - `value` union, required
        - string
        - number
        - boolean
    - `options_source` object
      - `catalog_id` string, required
      - `supports_search` boolean, required
      - `renderer` 'flat' | 'tree'
    - `allow_custom` boolean
    - `presets` object[]
      - `label` string, required
      - `min` union
        - number
        - string
      - `max` union
        - number
        - string
    - `threshold_presets` object[]
      - `label` string, required
      - `value` union, required
        - number
        - string
    - `operators` string[]
    - `default_operator` 'eq' | 'lt' | 'lte' | 'gt' | 'gte'
  - `require_any_of` string[]
  - `recipes` object[], required
    - `recipe_id` string, required
    - `title` string, required
    - `description` string, required
    - `visible_filter_keys` string[], required
    - `prefilled` object, required

## 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/sources/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/406ab2c4f714?raw)