---
title: "Every card on a board"
method: GET
path: "/boards/{id}/cards"
---

# Every card on a board

`GET /boards/{id}/cards`

## Request

- Base URL: `https://clusters.soleilpictures.com/api/v1`
- URL: `https://clusters.soleilpictures.com/api/v1/boards/{id}/cards`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

A page of cards

- object
  - `board_id` string, uuid
  - `cards` object[]
    - `id` string
    - `kind` 'note' | 'image' | 'link' | 'doc' | 'video' | 'audio' | 'pdf' | 'file'
    - `x` number
    - `y` number
    - `w` number
    - `h` number
    - `z` number
    - `title` string, nullable
    - `body` string, nullable: The text of the card, whatever kind it is.
    - `html` string, nullable
    - `url` string, nullable
    - `image_key` string, nullable: A key from POST /uploads. Image cards only.
    - `alt` string, nullable
    - `color` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `total` integer
  - `limit` integer
  - `offset` integer
  - `has_more` boolean
  - `next_offset` integer, nullable

---

[API](https://skmtc.dev/soleilpictures/apis/soleil-clusters-api.md) · [All operations](https://skmtc.dev/soleilpictures/apis/soleil-clusters-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soleilpictures/apis/soleil-clusters-api/revisions/1d426d587bf3?raw)