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

# Get List

`GET /v2/list/{list_id}`

View information about a List.

## Path parameters

- `list_id` number, required

## Response `200`

- object
  - `id` string
  - `name` string
  - `orderindex` integer
  - `content` string
  - `status` object
    - `status` string, required
    - `color` string, required
    - `hide_label` boolean, required
  - `priority` object
    - `priority` string, required
    - `color` string, required
  - `assignee` string, nullable
  - `task_count` string, nullable
  - `due_date` string
  - `due_date_time` boolean
  - `start_date` string, nullable
  - `start_date_time` string, nullable
  - `folder` object
    - `id` string, required
    - `name` string, required
    - `hidden` boolean, required
    - `access` boolean, required
  - `space` object
    - `id` string, required
    - `name` string, required
    - `access` boolean, required
  - `inbound_address` string
  - `archived` boolean
  - `override_statuses` boolean
  - `statuses` Status[] — unresolved $ref
  - `permission_level` string

---

[API](https://skmtc.dev/clickup/apis/clickup-api-v2-reference.md) · [All operations](https://skmtc.dev/clickup/apis/clickup-api-v2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clickup/clickup-api-v2-reference/revisions/72216f55b952/schema)