---
title: "List board tickets in column and rank order"
method: GET
path: "/api/v1/board/tickets"
---

# List board tickets in column and rank order

`GET /api/v1/board/tickets`

## Request

- Base URL: `https://tallymeter.com`
- URL: `https://tallymeter.com/api/v1/board/tickets`
- Auth: HTTP bearer

Tickets on a board, ordered by column then rank — the order shown on the board itself. Read the column before you rank or amend anything in it. Requires the `board:read` scope.

## Query parameters

- `board` string
- `column` string
- `label` string
- `limit` integer
- `offset` integer

## Response `200`

Tickets in board order

- object
  - `board` string
  - `total` integer: Every ticket matching the filters
  - `count` integer: Tickets on this page
  - `offset` integer
  - `next_offset` integer, nullable: The offset of the next page; null on the last page
  - `tickets` BoardTicket[]
    - `key` string
    - `title` string
    - `column` string
    - `entered_column_at` string, date-time, nullable: When the ticket entered the column it is in now; null if it has not moved since it was created or imported
    - `position` integer: 0-based rank within the column
    - `type` 'task' | 'bug' | 'story' | 'subtask' | 'epic'
    - `priority` 'high' | 'medium' | 'low'
    - `estimate_seconds` integer, nullable: null means unestimated, which is not the same as zero
    - `labels` string[]
    - `assignee` string, nullable

## Other responses

- `401`: Missing or invalid token
- `403`: Token lacks the required scope, or the account has no active plan
- `404`: No board in this workspace

---

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