---
title: "Get board by public ID"
method: GET
path: "/boards/{boardPublicId}"
tags: ["Boards"]
---

# Get board by public ID

`GET /boards/{boardPublicId}`

Retrieves a board by its public ID

## Path parameters

- `boardPublicId` string, required

## Query parameters

- `members` string[]
- `labels` string[]
- `lists` string[]
- `dueDateFilters` string[]
- `type` 'regular' | 'template'

## Response `200`

Successful response

- object
  - `publicId` string, required
  - `name` string, required
  - `slug` string, required
  - `visibility` string, required
  - `isArchived` boolean, required
  - `favorite` boolean, required
  - `workspace` object, required
    - `publicId` string, required
    - `cardPrefix` string, required
    - `members` object[], required
      - `publicId` string, required
      - `email` string, required
      - `status` string, required
      - `user` object, nullable, required
        - `id` string, nullable, required
        - `name` string, nullable, required
        - `email` string, required
        - `image` string, nullable, required
  - `labels` object[], required
    - `publicId` string, required
    - `name` string, required
    - `colourCode` string, nullable, required
  - `lists` object[], required
    - `publicId` string, required
    - `name` string, required
    - `index` number, required
    - `cards` object[], required
      - `publicId` string, required
      - `title` string, required
      - `description` string, nullable, required
      - `index` number, required
      - `cardNumber` number, nullable, required
      - `dueDate` string, nullable, required
      - `labels` object[], required
        - `publicId` string, required
        - `name` string, required
        - `colourCode` string, nullable, required
      - `members` object[], required
        - `publicId` string, required
        - `email` string, required
        - `user` object, nullable, required
          - `name` string, nullable, required
          - `email` string, required
          - `image` string, nullable, required
      - `attachments` object[], required
        - `publicId` string, required
      - `checklists` object[], required
        - `publicId` string, required
        - `name` string, required
        - `index` number, required
        - `items` object[], required
          - `publicId` string, required
          - `title` string, required
          - `completed` boolean, required
          - `index` number, required
      - `comments` object[], required
        - `publicId` string, required
  - `allLists` object[], required
    - `publicId` string, required
    - `name` string, required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/kan/apis/kan-api.md) · [All operations](https://skmtc.net/kan/apis/kan-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kan/kan-api/revisions/3235f0c88e7a/schema)