---
title: "Get list"
method: GET
path: "/lists/{listID}"
tags: ["lists"]
---

# Get list

`GET /lists/{listID}`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/lists/{listID}`
- Auth: API key in header `Authorization`

Get a list by ID

## Path parameters

- `listID` string, required

## Response `200`

List

- ListResponse
  - `companyFollowersFilters` CompanyFollowersFilters
    - `countries` string[]
    - `departments` string[]
    - `description` string
    - `followerCount` integer
    - `jobTitles` string[]
    - `levels` string[]
    - `limit` integer
    - `linkedinURL` string
    - `logo` string
    - `maxContactsPerCompany` integer
    - `metros` string[]
    - `name` string
    - `states` string[]
    - `website` string
  - `companyLookalikeFilters` CompanyLookalikeFilters
    - `categories` string[]
    - `companyEmployeeRanges` string[]
    - `excludeCategories` string[]
    - `excludeCompanyEmployeeRanges` string[]
    - `excludeDomains` string[]
    - `excludeFundingStages` string[]
    - `excludeLocations` CompanyLookalikesLocation[]
      - `id` string, required
      - `type` 'region' | 'country', required
    - `fundingStages` string[]
    - `limit` integer
    - `locations` CompanyLookalikesLocation[]
      - `id` string, required
      - `type` 'region' | 'country', required
    - `lookalikeDomains` string[]
  - `createdAt` string
  - `displayOptions` DisplayOptions
    - `canReply` boolean
    - `leadsDisplayMode` 'none' | 'preview'
    - `progressState` 'none' | 'filtering' | 'searching' | 'completed' | 'failed'
    - `selectedPath` 'none' | 'icp' | 'company_lookalikes' | 'company_followers' | 'uploaded_contacts' | 'extension' | 'signals_funding' | 'signals_investors' | 'signals_job_change' | 'signals_acquisitions' | 'maps_discovery' | 'signals_hiring'
  - `enriched` boolean: Enriched is true when at least one contact has an enriched email, phone, LinkedIn or qualification result.
  - `filterCounts` FilterCountsResponse
    - `companyBusinessModels` integer
    - `companyDomains` integer
    - `companyEmployeeNumberRange` integer
    - `companyFoundedYearRange` integer
    - `companyFundingRounds` integer
    - `companyIndustries` integer
    - `companyKeywords` integer
    - `companyLocations` integer
    - `companyNames` integer
    - `companyNiches` integer
    - `companyRevenueRanges` integer
    - `companyTechnologies` integer
    - `companyTypes` integer
    - `companyYearsInBusinessRange` integer
    - `leadDepartments` integer
    - `leadIDs` integer
    - `leadJobTitles` integer
    - `leadLanguages` integer
    - `leadLocations` integer
    - `leadSeniorities` integer
    - `leadTenure` integer
  - `filters` PersonSearchFilters
    - `companyBusinessModels` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `companyDomains` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `companyEmployeeNumberRange` MinMaxFilter
      - `max` integer
      - `min` integer
    - `companyFoundedYearRange` MinMaxFilter
      - `max` integer
      - `min` integer
    - `companyFundingRounds` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `companyIDs` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `companyIndustries` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `companyKeywords` IncludeExcludeAllFilter
      - `exclude` string[]
      - `include` string[]
      - `matchAll` boolean
    - `companyLocations` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `companyNames` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `companyNiches` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `companyRequired` boolean
    - `companyRevenueRanges` RevenueCategory[]
    - `companyTechnologies` AnyAllFilter
      - `all` string[]
      - `any` string[]
    - `companyTypes` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `companyYearsInBusinessRange` MinMaxFilter
      - `max` integer
      - `min` integer
    - `leadDepartments` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `leadIDs` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `leadJobTitles` JobTitleFilter
      - `exactMatch` boolean
      - `exclude` string[]
      - `include` string[]
    - `leadLanguages` LanguageFilter
      - `exclude` string[]
      - `include` string[]
      - `primaryOnly` boolean
    - `leadLocations` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `leadSeniorities` IncludeExcludeFilter
      - `exclude` string[]
      - `include` string[]
    - `leadTenure` MinMaxFilter
      - `max` integer
      - `min` integer
    - `maxContactsPerCompany` integer
  - `id` string
  - `messages` MessageResponse[]
    - `actions` MessageActions
      - `options` MessageAction[]
        - `id` string
        - `text` string
        - `value` string
      - `selectionMode` 'single' | 'suggestion' | 'custom'
    - `created_at` string
    - `extraData` unknown
    - `id` string
    - `role` 'system' | 'user'
    - `status` 'pending' | 'ready'
    - `text` string
  - `name` string
  - `refreshContacts` boolean
  - `resolvedFilters` ResolvedFilterValues
    - `companyFundingRounds` object
    - `companyIDs` object
    - `companyTypes` object
  - `signalFilters` object
  - `updatedAt` string

## Other responses

- `404`: List Not Found
- `500`: Internal Server Error

---

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