---
title: "List the token owner's prospect lists"
method: GET
path: "/business/lists"
tags: ["Lists"]
---

# List the token owner's prospect lists

`GET /business/lists`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/lists`
- Auth: HTTP basic

Pages through the workspace's prospect lists, newest-created first; system-generated lists (All Enriched Contacts and the like) are never included. `entityType` restricts to contact or company lists, `folderId` to one folder, and `search` matches list names case-insensitively. Each row carries its kind, its contact/company counts, and the folder it sits in (`folderId: null` = root). Use `pageNum`/`limit` to page (`pagination.totalRecords` is the overall count).

Errors:
- `422` `VALIDATION_FAILED` — A query parameter failed validation (e.g. limit above 1000, folderId not a 24-hex id).
- `429` `RATE_LIMITED` — The lists rate bucket (120/min, 10,000/day per token owner) is exhausted.

Requires one of the following token scopes: lists.

## Query parameters

- `limit` integer: Page size: how many lists to return per page (1-1000, default 50).
- `pageNum` integer: 1-based page number (default 1); lists are ordered newest-created first.
- `entityType` 'contactList' | 'companyList': Restrict to one list kind: contactList (people) or companyList (companies); omit for both.
- `folderId` string: Only lists inside this folder (24-character hex folder id from GET /business/folders).
- `search` string: Free text (1-200 characters), matched as a case-insensitive substring of the list name; every character is literal, so * and ? are not wildcards and no other field (folder, owner, description) is searched.

## Response `200`

Success

- object
  - `data` object[], required
    - `id` string, required
    - `name` string, required
    - `entityType` 'contactList' | 'companyList', required
    - `contactsCount` integer, required
    - `companiesCount` integer, required
    - `createdAt` string, required
    - `folderId` string, nullable, required
  - `pagination` object, required
    - `pageNum` integer, required
    - `totalPages` integer
    - `totalRecords` integer

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)