---
title: "Get metadata on a single List"
method: GET
path: "/v2/lists/{listId}"
tags: ["Lists"]
---

# Get metadata on a single List

`GET /v2/lists/{listId}`

Retrieve detailed information about a specific List you have access to view.
Returns List configuration including name, owner, privacy settings, and creation details.

## Path parameters

- `listId` integer, required

## Response `200`

OK

- ListWithType — ListWithType model
  - `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

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `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)