---
title: "List your boards"
method: GET
path: "/v1/dashboards"
tags: ["Boards"]
---

# List your boards

`GET /v1/dashboards`

## Request

- Base URL: `https://api.stackdata.io`
- URL: `https://api.stackdata.io/v1/dashboards`
- Auth: one of:
  - none
  - API key in header `X-API-Key`

## Response `200`

Your boards, newest first.

- object
  - `dashboards` BoardSummary[]
    - `id` string
    - `title` string
    - `updated_at` string
    - `items` integer: Number of items on the board.
    - `visibility` 'public' | 'private'
    - `public` boolean: Effective public state (a forced-public free board is public even if visibility says otherwise).
    - `forced_public` boolean: True when the free-tier rule forces this board public.
  - `meta` Meta: Attached to every JSON response. `harvest` maps each source id to its last successful harvest timestamp.
    - `harvest` object
    - `api_version` string

---

[API](https://skmtc.dev/stackdata/apis/stackdata-api.md) · [All operations](https://skmtc.dev/stackdata/apis/stackdata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stackdata/apis/stackdata-api/revisions/91358ae3f6e8?raw)
