---
title: "List boards in the caller's org"
method: GET
path: "/boards"
tags: ["Boards"]
---

# List boards in the caller's org

`GET /boards`

## Request

- Base URL: `https://api-docs.jackhamr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.jackhamr.ai/boards`
- Auth: none declared

List boards the caller can see, newest first.

Delegates to ``board_service.list_boards`` which resolves boards
through the user's org memberships (including virtual orchestrator
boards). The result is cursor-paginated in-memory via the shared
``build_cursor_from_rows`` helper.

## Query parameters

- `limit` integer
- `cursor` string, nullable

## Response `200`

Successful Response

- PaginatedResponseBoardOut
  - `data` BoardOut[]
    - `id` string, required
    - `name` string, required
    - `description` string, nullable
    - `accent` string, nullable
    - `icon` string, nullable
    - `status` string
    - `execution_mode` string
    - `orchestrator_skill_id` string, nullable
    - `is_virtual` boolean
    - `team` AgentRef[]
      - `id` string, required
      - `name` string, required
      - `status` string, nullable
      - `clone_of_agent_id` string, nullable
    - `card_count` integer
    - `done_count` integer
    - `waiting_count` integer
    - `progress` number
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

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