---
title: "Get metadata on all Lists"
method: GET
path: "/v2/lists"
tags: ["Lists"]
---

# Get metadata on all Lists

`GET /v2/lists`

Paginate through all Lists in your organization that you have access to view.
Returns basic information about each List, including name, owner, and privacy settings.

## Query parameters

- `term` string
- `cursor` string
- `limit` integer

## Response `200`

OK

- ListWithTypePaged — ListWithTypePaged model
  - `data` ListWithType[], required — A page of ListWithType results
    - `id` integer, required — The unique identifier for the list
    - `name` string, required — The name of the list
    - `creatorId` integer, required — The ID of the user that created this list
    - `ownerId` integer, required — The ID of the user that owns this list
    - `isPublic` boolean, required — Whether or not the list is public
    - `type` 'company' | 'opportunity' | 'person', required — The entity type for this list
    - `createdAt` string, date-time, required — The date and time the list was created
  - `pagination` Pagination, required
    - `prevUrl` string, uri, nullable — URL for the previous page
    - `nextUrl` string, uri, nullable — URL for the next page

## Other responses

- `400` — Bad Request
- `default` — Errors

---

[API](https://skmtc.net/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.net/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/revisions/4c2891c31b7f/schema)