---
title: "List views for object"
method: GET
path: "/v2/objects/{object}/views"
tags: ["Objects"]
---

# List views for object

`GET /v2/objects/{object}/views`

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

Required scopes: `object_configuration:read`.

## Path parameters

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

## 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` ObjectView[], required
    - `id` object, required
      - `workspace_id` string, uuid, required — A UUID identifying the workspace this view belongs to.
      - `object_id` string, uuid, required — A UUID identifying the object this view belongs to.
      - `view_id` string, uuid, required — A UUID identifying this view. Use this value as `filter_view_id` when listing records.
    - `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)