Skip to main content
With our Lists API, you can manage the lists in your workspace: fetch your team’s lists, read their items, add new items, and queue an export of a list.

​
Object types

Every list is homogeneous — it holds a single type of object, described by its objectType:
  • COMPANY — companies
  • LEGAL_ENTITY — legal entities
  • CONTACT — contacts (a contact is always tied to a company)
The objectType determines the shape of the items returned by the results endpoint and the shape accepted when adding items.

​
Identifiers

List IDs (listId) are obfuscated. You obtain them from the overview endpoint and pass them back to the other endpoints.

​
Authorization

The Public API token is team-scoped. Every request only operates on lists that belong to your team; requesting a list from another team returns 404.