---
title: "Fetch a lead list"
method: GET
path: "/lists/{id}"
tags: ["Lists"]
---

# Fetch a lead list

`GET /lists/{id}`

## Request

- Base URL: `https://api.wappalyzer.com/v2`
- URL: `https://api.wappalyzer.com/v2/lists/{id}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/wappalyzer/apis/wappalyzer-public-api/docs/lists/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Response `200`

Lead list returned successfully.

- ListDetail
  - `id` string, required
  - `suppressionListId` string, nullable: A Ready suppression list uploaded by this account, containing domains to exclude. Its domains are fixed once validated. Can be combined with excludeListId to also exclude websites from an existing lead list. Exclusions apply before result limits and credit calculation.
  - `createdAt` integer
  - `status` 'Calculating' | 'Ready' | 'Failed' | 'Insufficient' | 'Complete', required
  - `technologies` ListTechnology[]
    - `slug` string
    - `name` string
    - `operator` string
    - `version` string, nullable
    - `categories` Category[]
      - `id` integer
      - `slug` string, required
      - `name` string, required
  - `keywords` string[]
  - `languages` string[]
  - `countries` string[]
  - `industries` string[]
  - `companySizes` union[]
    - union
      - integer
      - string
  - `tlds` string[]
  - `matchCountryLanguage` boolean
  - `matchTechnologies` 'or' | 'and' | 'not'
  - `subset` integer
  - `subsetSlice` integer
  - `minAge` integer
  - `maxAge` integer
  - `fromDate` integer, nullable
  - `requiredSets` string[]
  - `excludeNoTraffic` boolean
  - `excludeMultilingual` boolean
  - `sets` string[]: Result field sets included in the exported rows. `signals` adds `technologySpend` and `trafficLevel` columns.
  - `callbackUrl` string, uri, nullable
  - `totalCredits` integer
  - `url` string, uri, nullable
  - `sampleUrl` string, uri
  - `rows` object
  - `setRows` object

## Other responses

- `400`: The request payload or query string was invalid.
- `403`: Authorization failed, the resource or method is invalid, or the account lacks sufficient credits.
- `429`: Rate limit exceeded.

---

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