---
title: "Get the list of dashboards in an application."
method: GET
path: "/dashboards"
---

# Get the list of dashboards in an application.

`GET /dashboards`

## Query parameters

- `api-version` string, required
- `filter` string
- `maxpagesize` integer
- `orderby` string

## Response `200`

Success

- DashboardCollection — The paged results of dashboards.
  - `value` Dashboard[], required — The collection of dashboards.
    - `id` string — Unique ID of the dashboard.
    - `displayName` string, required — Display name of the dashboard.
    - `tiles` Tile[] — The tiles displayed by the dashboard.
      - `id` string — Unique ID of the tile.
      - `displayName` string, required — Display name of the tile.
      - `configuration` TileConfiguration, required — Configuration specifying information about a tile.
        - `type` string, required — The type of widget the tile renders
      - `height` number, required — Height of the tile
      - `width` number, required — Width of the tile
      - `x` number, required — Horizontal position of the tile
      - `y` number, required — Vertical position of the tile
    - `personal` boolean — Whether the dashboard is personal and can only be viewed by the current user.
    - `favorite` boolean — Whether the dashboard is favorited or not
    - `etag` string — Etag to prevent conflict when updating the dashboard.
    - `organizations` string[] — The organization the dashboard belongs to. If not present, the dashboard is root-level or personal. only one organization is supported today, multiple organizations will be supported soon.
  - `nextLink` string — URL to get the next page of dashboards.

## Other responses

- `default` — An error response received from the IoT Central Service.

---

[API](https://skmtc.net/azure/apis/iotcentral-iotcentral.md) · [All operations](https://skmtc.net/azure/apis/iotcentral-iotcentral/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/iotcentral-iotcentral/versions/565d8813cbd3/schema)