Skip to main content
GET
List the token owner's prospect lists

Authorizations

Authorization
string
header
required

Your API token (af_…) as the Basic-auth username, with an empty password.

Query Parameters

limit
integer
default:50

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

Required range: 1 <= x <= 1000
pageNum
integer
default:1

1-based page number (default 1); lists are ordered newest-created first.

Required range: x >= 1
entityType
enum<string>

Restrict to one list kind: contactList (people) or companyList (companies); omit for both.

Available options:
contactList,
companyList
folderId
string

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

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.

Required string length: 1 - 200

Response

Success

data
object[]
required
pagination
object
required