---
title: "Get a ticket and its thread (any org member; internal notes are never included)"
method: GET
path: "/v1/orgs/{org_id}/tickets/{reference}"
tags: ["tickets"]
---

# Get a ticket and its thread (any org member; internal notes are never included)

`GET /v1/orgs/{org_id}/tickets/{reference}`

## Request

- Base URL: `https://api.wavehouse.cloud`
- URL: `https://api.wavehouse.cloud/v1/orgs/{org_id}/tickets/{reference}`
- Auth: one of:
  - API key in cookie `whc_session`
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `org_id` string, required
- `reference` string, required

## Response `200`

OK

- TicketView
  - `category` string, required: bug | feature_request | question | billing | other
  - `created_at` string, date-time, required
  - `human_requested` boolean
  - `last_message_at` string, date-time, required
  - `messages` TicketMessageView[], required
    - `author_email` string
    - `author_kind` string, required: customer | operator | system
    - `body` string, required
    - `created_at` string, date-time, required
    - `message_id` string, required
  - `project_id` string
  - `reference` string, required: The ticket's handle, e.g. WHC-R-4KP9QX2M
  - `reply_count` integer: list only: messages after the opening one; nonzero means the team (or a watcher) has replied
  - `status` string, required: open | waiting_on_customer | waiting_on_us | resolved | closed
  - `subject` string, required
  - `watchers` TicketParticipantView[], required
    - `email` string, required
    - `notify` boolean, required
    - `role` string, required: reporter | watcher

## Other responses

- `429`: Rate limited, per client IP, API key or org; a client IP is also refused on every route for a while after repeated authentication failures. A limited operation carries RateLimit-Policy and RateLimit on every response; wait Retry-After seconds before retrying.
- `default`: Error

---

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