---
title: "Get a list"
method: GET
path: "/v2/lists/{list}"
tags: ["Lists"]
---

# Get a list

`GET /v2/lists/{list}`

Gets a single list in your workspace that your access token has access to.

Required scopes: `list_configuration:read`.

## Path parameters

- `list` string, required — A UUID or slug to identify the list.

## Response `200`

Success

- object — Success
  - `data` List, required
    - `id` object, required
      - `workspace_id` string, uuid, required — A UUID to identify the workspace this list belongs to.
      - `list_id` string, uuid, required — A UUID to identify this list.
    - `api_slug` string, required — A human-readable slug for use in URLs and responses.
    - `name` string, required — The name of the list, as viewed in the UI.
    - `parent_object` string[], required — A UUID or slug to identify the allowed object type for records added to this list. All new Lists are expected to have exactly one parent object. However, some legacy lists may have multiple allowed parents so the return type of this field is an array.
    - `workspace_access` 'full-access' | 'read-and-write' | 'read-only', nullable, required — The level of access granted to all members of the workspace for this list. `null` values represent a private list that only grants access to specific workspace members via the `workspace_member_access` property.
    - `workspace_member_access` object[], required — The level of access granted to specific workspace members for this list. An empty array represents a list that has granted access to no workspace members.
      - `workspace_member_id` string, uuid, required — A UUID to identify the workspace member to grant access to.
      - `level` 'full-access' | 'read-and-write' | 'read-only', required — The level of access to the list.
    - `created_by_actor` object, required — The actor which created this list.
      - `id` string, nullable — An ID to identify the actor.
      - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
    - `created_at` string, required — When the list was created.

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/attio/apis/attio-api.md) · [All operations](https://skmtc.net/attio/apis/attio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attio/attio-api/versions/40a8e41d06a2/schema)