Skip to main content
GET
Get a ticket

Authorizations

Authorization
string
header
required

API key from your account settings

Path Parameters

agentId
string
required

The agent ID

Minimum string length: 1
Example:

"5QHA6VB-DIAbBhxwqxfdi"

ticketNumber
integer
required

The ticket number

Required range: x <= 2147483647
Example:

123

Response

The ticket

ticketNumber
integer
required

The ticket number

Example:

123

subject
string | null
required

Ticket subject

description
string | null
required

Ticket description

statusCategory
enum<string>
required

Status category driving color/ordering semantics

Available options:
new,
on_you,
on_customer,
on_hold,
closed,
cancelled
Example:

"on_customer"

statusId
string
required

ID of the ticket status. Resolve label/color via /ticket-statuses.

assigneeId
string | null
required

ID of the assigned agent user, or null when unassigned

customer
object
required
metadata
object
required

Arbitrary extra fields captured on the ticket

Example:
channel
enum<string>
required

Channel the ticket originated from

Available options:
helpdesk,
iframe,
email,
whatsapp,
api,
messenger,
instagram,
center_stage,
phone
Example:

"email"

conversationId
string | null
required

ID of the linked conversation, if any

teamId
string | null
required

ID of the assigned team, or null. Resolve via /teams.

createdAt
string
required

ISO 8601 creation timestamp

Example:

"2026-07-20T12:34:56.000Z"

updatedAt
string
required

ISO 8601 timestamp of the last update

Example:

"2026-07-21T09:00:00.000Z"

lastMessageAt
string | null
required

ISO 8601 timestamp of the most recent message, or null if the ticket has no messages

Example:

"2026-07-21T08:55:00.000Z"