> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizzy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

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](/api-reference/v2/lists/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`.