Skip to main content

List Views

Retrieves a list of views.

This tool returns a single page of up to 1000 views per call. The response is a flat object of the shape { data, totalAvailable } (see Example result). To collect every view, start at pageNumber: 1 and increment pageNumber on each subsequent call until you have collected totalAvailable items.

To get the count of views matching the request, read totalAvailable from a single call (for example, pageNumber: 1) without paging through every item.

APIs called​

Optional arguments​

filter​

A filter expression as defined in the Tableau REST API Views filter fields.

Example: name:eq:Overview

limit​

The maximum number of views to return from the requested page. Must be a positive integer no greater than 1000 (the fixed page size). Use this to fetch fewer than a full page — for example, to request a partial final page. It does not fetch across pages.

Example: 600

See also: MAX_RESULT_LIMIT, the overall cap on how many results can be paginated through across all pages.

pageNumber​

Which 1000-item page of views to fetch. This is a 1-based page index (page size is fixed at 1000); when omitted it defaults to 1. Increment pageNumber across calls to page through the full result set.

When a server-side MAX_RESULT_LIMIT is configured, only pages that fall within that cap are reachable. For example, with a limit of 2700 the highest page you can request is 3 (page 3 returns the final 700 items). Requesting a higher page returns an error describing the valid page range rather than an empty result.

Example: 2

Example result​

{
  "data": [
    {
      "id": "9460abfe-a6b2-49d1-b998-39e1ebcc55ce",
      "name": "Overview",
      "createdAt": "2025-09-02T23:25:58Z",
      "updatedAt": "2025-09-02T23:25:58Z",
      "workbook": {
        "id": "222ea993-9391-4910-a167-56b3d19b4e3b"
      },
      "owner": {
        "id": "d2a1e1df-af8e-4f43-a4cc-34858b7f8b69"
      },
      "project": {
        "id": "cbec32db-a4a2-4308-b5f0-4fc67322f359"
      },
      "tags": {},
      "totalViewCount": 0
    }
  ],
  "totalAvailable": 1
}

The response fields are:

  • data: the views on the requested page (at most 1000, or fewer when limit or a server cap applies).
  • totalAvailable: the number of views available for pagination (Your own limit argument does not affect this value).