---
title: "List views for list"
method: GET
path: "/v2/lists/{list}/views"
tags: ["Lists"]
---

# List views for list

`GET /v2/lists/{list}/views`

Lists saved views for a list. Results are ordered by view ID (`id.view_id` ascending).

Required scopes: `list_configuration:read`.

## Path parameters

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

## Query parameters

- `show_archived` boolean — `true` to include archived views. See our [archiving guide](/docs/archiving-vs-deleting) for more information on archiving.
- `limit` integer — The maximum number of views to return. Must be between 1 and 1000. Defaults to 500.
- `cursor` string — A pagination cursor from a previous response's `pagination.next_cursor`. Omit for the first page.

## Response `200`

Success

- object — Success
  - `data` ListView[], required
    - `id` object, required
      - `workspace_id` string, uuid, required — A UUID identifying the workspace this view belongs to.
      - `list_id` string, uuid, required — A UUID identifying the list this view belongs to.
      - `view_id` string, uuid, required — A UUID identifying this view. Use this value as `filter_view_id` when listing entries.
    - `title` string, required — The title of the view shown in the Attio app.
    - `created_at` string, required — When the view was created.
  - `pagination` object, required
    - `next_cursor` string, nullable, required

## 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)