---
title: "List page contacts"
method: GET
path: "/lists/{listID}/contacts"
tags: ["lists"]
---

# List page contacts

`GET /lists/{listID}/contacts`

## Request

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

List contacts found for list filters

## Path parameters

- `listID` string, required

## Query parameters

- `cursor` string
- `size` integer

## Response `200`

Contacts

- ListContactsResponse
  - `cursor` string
  - `emptyStateType` 'none' | 'all_enriched' | 'no_results'
  - `endReached` boolean
  - `leads` ListContactResponse[]
    - `company` string
    - `companyFundingRound` 'ANGEL' | 'PRE_SEED' | 'SEED' | 'VENTURE_SERIES_UNKNOWN' | 'SERIES_A' | 'SERIES_B' | 'SERIES_C' | 'SERIES_D' | 'SERIES_E' | 'SERIES_F' | 'SERIES_G' | 'SERIES_H' | 'SERIES_I' | 'SERIES_J' | 'EQUITY_CROWDFUNDING' | 'PRODUCT_CROWDFUNDING' | 'PRIVATE_EQUITY' | 'CONVERTIBLE_NOTE' | 'DEBT_FINANCING' | 'SECONDARY_MARKET' | 'GRANT' | 'CORPORATE_ROUND' | 'INITIAL_COIN_OFFERING' | 'POST_IPO_EQUITY' | 'POST_IPO_DEBT' | 'POST_IPO_SECONDARY' | 'NON_EQUITY_ASSISTANCE' | 'FUNDING_ROUND' | 'UNDISCLOSED' | 'UNKNOWN'
    - `companyLocation` string
    - `companyLogo` string
    - `companyRevenueRange` ListContactRevenueRange
      - `end` integer
      - `start` integer
    - `companySize` integer
    - `companyType` 'EDUCATIONAL' | 'GOVERNMENT_AGENCY' | 'NON_PROFIT' | 'PARTNERSHIP' | 'PRIVATELY_HELD' | 'PUBLIC_COMPANY' | 'SELF_EMPLOYED' | 'SELF_OWNED' | 'UNKNOWN'
    - `companyWebsite` string
    - `companyYearsInBusiness` integer
    - `firstName` string
    - `id` string
    - `industries` string[]
    - `industry` string
    - `jobTitle` string
    - `keywords` string[]
    - `lastName` string
    - `linkedinUrl` string
    - `location` string
    - `lookalikeCompanyCategories` CompanyCategory[]
    - `lookalikeCompanyFundingStage` 'seed' | 'debt_financing' | 'angel' | 'venture' | 'series_a' | 'series_b' | 'series_c' | 'series_d' | 'series_e' | 'series_f' | 'series_g' | 'series_h' | 'other'
    - `lookalikeCompanyScore` number
    - `profilePictureUrl` string
    - `tooltip` TooltipResponse
      - `evidence` object
      - `success` boolean
  - `limitReached` boolean

## Other responses

- `400`: Bad Request
- `410`: Cursor expired or invalid
- `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)