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

# Lists

Includes metadata on all Affinity Lists including name, owner, creator, type, and public/private status.

**Name:** `v1_0.lists`

Deleted and merged records are covered in [Deletes & Merges](https://developer.affinity.co/pages/data-share/deletes.md).

> [!WARNING]
>
> Grant access to the share only to users who are authorized to view all
> organization data. There are no per-user or per-role visibility filters applied at the
> share level.

## Columns

| Column | Description |
| - | - |
| `id` | The list's unique identifier |
| `name` | The name of the list |
| `is_public` | Whether or not the list is public |
| `owner_id` | The ID of the user that owns this list |
| `creator_id` | The ID of the user that created this list |
| `type` | The entity type for this list (person, company, or opportunity) |
| `is_deleted` | Whether the list has been deleted |
| `last_updated_at` | Timestamp when this record was last updated |


## Related topics

- [Add a List Entry to a List](https://developer.affinity.co/api-reference/2026-09-17/lists/add-a-list-entry-to-a-list.md)
- [List Entries](https://developer.affinity.co/pages/data-share/list_entries_v1_0.md)
- [Create a List](https://developer.affinity.co/api-reference/2026-07-15/lists/create-a-list.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.