---
title: "Service Desk - ticket detail"
method: GET
path: "/ServiceDesk/Tickets/{ticketId}"
tags: ["Servicedesk"]
---

# Service Desk - ticket detail

`GET /ServiceDesk/Tickets/{ticketId}`

**Requires permission:** *IT*

One ticket with its conversation thread, the Staff Lifecycle request behind it (when it has one), the requester's Panoptic record and their recent ticket history. Requires the IT permission.

## Path parameters

- `ticketId` integer, required

## Response `200`

Success

- GetServiceDeskTicketResponse
  - `ticket` ServiceDeskTicket
    - `id` integer, nullable
    - `subject` string, nullable
    - `statusId` integer, nullable
    - `status` string, nullable
    - `priorityId` integer, nullable
    - `priority` string, nullable
    - `category` string, nullable
    - `subCategory` string, nullable
    - `type` string, nullable
    - `requesterId` integer, nullable
    - `requesterName` string, nullable
    - `requesterEmail` string, nullable
    - `agentId` integer, nullable
    - `agentName` string, nullable
    - `groupId` integer, nullable
    - `createdUtc` string, date-time, nullable
    - `updatedUtc` string, date-time, nullable
    - `dueByUtc` string, date-time, nullable
    - `plannedStartUtc` string, date-time, nullable
    - `plannedEndUtc` string, date-time, nullable
    - `overdue` boolean
    - `startingSoon` boolean
    - `minutesUntilStart` integer, nullable
    - `stale` boolean
    - `daysSinceUpdate` integer, nullable
    - `tags` string[]
    - `workspaceId` integer, nullable
    - `url` string, nullable
    - `lifecycle` ServiceDeskLifecycleLink
      - `requestId` integer
      - `requestType` string, nullable
      - `requestStatus` string, nullable
      - `personName` string, nullable
      - `personEmail` string, nullable
      - `jobTitle` string, nullable
      - `department` string, nullable
      - `lineManagerEmail` string, nullable
      - `keyDate` string, date-time, nullable
      - `keyDateLabel` string, nullable
      - `submitterEmail` string, nullable
      - `submittedUtc` string, date-time, nullable
      - `siblingTotal` integer
      - `siblingDone` integer
      - `siblings` ServiceDeskLifecycleSibling[]
        - `kind` string, nullable
        - `status` string, nullable
        - `ticketId` integer, nullable
        - `done` boolean
        - `resolvedUtc` string, date-time, nullable
        - `error` string, nullable
  - `descriptionHtml` string, nullable
  - `conversations` GetServiceDeskTicketConversationItem[]
    - `id` integer, nullable
    - `bodyHtml` string, nullable
    - `bodyText` string, nullable
    - `private` boolean
    - `incoming` boolean
    - `authorName` string, nullable
    - `createdUtc` string, date-time, nullable
    - `notifiedEmails` string[]
    - `attachments` GetServiceDeskTicketAttachmentItem[]
      - `name` string, nullable
      - `url` string, nullable
      - `size` integer, nullable
      - `contentType` string, nullable
  - `requesterHistory` ServiceDeskTicket[]
    - `id` integer, nullable
    - `subject` string, nullable
    - `statusId` integer, nullable
    - `status` string, nullable
    - `priorityId` integer, nullable
    - `priority` string, nullable
    - `category` string, nullable
    - `subCategory` string, nullable
    - `type` string, nullable
    - `requesterId` integer, nullable
    - `requesterName` string, nullable
    - `requesterEmail` string, nullable
    - `agentId` integer, nullable
    - `agentName` string, nullable
    - `groupId` integer, nullable
    - `createdUtc` string, date-time, nullable
    - `updatedUtc` string, date-time, nullable
    - `dueByUtc` string, date-time, nullable
    - `plannedStartUtc` string, date-time, nullable
    - `plannedEndUtc` string, date-time, nullable
    - `overdue` boolean
    - `startingSoon` boolean
    - `minutesUntilStart` integer, nullable
    - `stale` boolean
    - `daysSinceUpdate` integer, nullable
    - `tags` string[]
    - `workspaceId` integer, nullable
    - `url` string, nullable
    - `lifecycle` ServiceDeskLifecycleLink
      - `requestId` integer
      - `requestType` string, nullable
      - `requestStatus` string, nullable
      - `personName` string, nullable
      - `personEmail` string, nullable
      - `jobTitle` string, nullable
      - `department` string, nullable
      - `lineManagerEmail` string, nullable
      - `keyDate` string, date-time, nullable
      - `keyDateLabel` string, nullable
      - `submitterEmail` string, nullable
      - `submittedUtc` string, date-time, nullable
      - `siblingTotal` integer
      - `siblingDone` integer
      - `siblings` ServiceDeskLifecycleSibling[]
        - `kind` string, nullable
        - `status` string, nullable
        - `ticketId` integer, nullable
        - `done` boolean
        - `resolvedUtc` string, date-time, nullable
        - `error` string, nullable
  - `requester` GetServiceDeskTicketRequesterProfile
    - `name` string, nullable
    - `email` string, nullable
    - `jobTitle` string, nullable
    - `staffType` string, nullable
    - `school` string, nullable
    - `extension` string, nullable
    - `mobile` string, nullable
    - `matchedStaffRecord` boolean
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `401` — Unauthorized
- `403` — Missing IT permission
- `404` — Ticket not found

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/revisions/4d9bcf62aa69/schema)
