Lists

List the token owner's prospect lists

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.

get/business/lists

Request

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

Query parameters

limitinteger

Page size: how many lists to return per page (1-1000, default 50).

pageNuminteger

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.

folderIdstring

Only lists inside this folder (24-character hex folder id from GET /business/folders).

searchstring

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

Success

Changes

No recorded changes to this operation across all 1 revision of this API.