---
title: "Read one ticket"
method: GET
path: "/api/v1/board/tickets/{key}"
---

# Read one ticket

`GET /api/v1/board/tickets/{key}`

## Request

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

One ticket in full: the markdown description, comments, labels, estimate, logged and remaining time, parent, children, links and attachments. Read it before amending or working on a ticket. Requires the `board:read` scope.

## Path parameters

- `key` string, required

## Response `200`

The ticket

- object
  - `key` string
  - `title` string
  - `description` string, nullable: markdown
  - `column` string
  - `type` string
  - `priority` string
  - `estimate_seconds` integer, nullable
  - `logged_seconds` integer
  - `remaining_seconds` integer, nullable
  - `assignee` string, nullable
  - `reporter` string, nullable
  - `labels` string[]
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `parent` object, nullable
    - `key` string
    - `title` string
  - `children` object[]
    - `key` string
    - `title` string
  - `links` object[]
    - `relation` string
    - `key` string
    - `title` string
    - `column` string
  - `comments` object[]
    - `author` string, nullable
    - `body` string: markdown
    - `created_at` string, date-time
  - `attachments` object[]
    - `filename` string
    - `url` string
    - `size_bytes` integer
  - `history` object[]: Newest first, ending with its creation: every move between columns, rank, estimate, assignee, priority, type and label change, with who made it
    - `at` string, date-time
    - `text` string: e.g. "Ada moved it from In Progress to Review through MCP"

## Other responses

- `401`: Missing or invalid token
- `403`: Token lacks the required scope, or the account has no active plan
- `404`: No such ticket 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)