---
title: "List tickets"
method: GET
path: "/api/v1/tickets/"
tags: ["tickets"]
---

# List tickets

`GET /api/v1/tickets/`

Lists tickets with optional filtering and pagination

## Query parameters

- `page` integer
- `page_size` integer
- `sort_by` 'title' | 'priority' | 'source' | 'status' | 'created_at' | 'resolution_sla'
- `sort_direction` 'asc' | 'desc'
- `title` string, nullable
- `description` string, nullable
- `ticket_type` TicketType[], nullable
- `priority` TicketPriority[], nullable
- `status` TicketStatus[], nullable
- `reporter` string[], nullable
- `assignee` string[], nullable — Use '_UNASSIGN_' for unassigned
- `desk_id` string[], nullable
- `subdesk_id` string[], nullable — Filter by subdesk (team) IDs
- `tag_ids` integer[], nullable
- `tag_names` string[], nullable
- `source` TicketSource[], nullable
- `vip_reporter` boolean, nullable — Filter tickets by VIP status of the reporter employee
- `location_reporter` string[], nullable — Filter tickets by location of the reporter employee

## Response `200`

Successful Response

- TicketsListResponse
  - `items` TicketResponse[], required
    - `id` string, required
    - `title` string, required
    - `description` string, nullable
    - `ticket_type` 'request' | 'incident' | 'question', required
    - `priority` 'low' | 'medium' | 'high' | 'urgent', required
    - `source` 'slack' | 'harmony' | 'teams' | 'freshservice' | 'jsm' | 'solarwinds' | 'email' | 'siit', required
    - `status` 'open' | 'in_progress' | 'pending' | 'pending_reporter' | 'pending_approval' | 'pending_internal_team' | 'pending_third_party' | 'resolved' | 'closed' | 'canceled', required
    - `reporter` string, required
    - `created_by` string, required
    - `assignee` string, nullable
    - `desk_id` string, required
    - `subdesk_id` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `custom_fields` object, nullable, required — Custom field values for the current desk
    - `ticket_metadata` object, nullable — Additional metadata for the ticket
    - `kb_resolution` KBResolutionResponse — Knowledge base resolution suggestion for a ticket.
      - `answer_summary` string, required — 2-3 sentence summary of the suggested resolution
      - `sources` KBSourceResponse[] — Source citations for the resolution
        - `url` string, required — URL of the source document
        - `title` string, nullable — Title of the source document
      - `chunks_count` integer, required — Number of KB chunks used to generate the resolution
      - `confidence` number, nullable — Confidence score for the KB answer (0.0-1.0)
      - `queried_at` string, date-time, required — Timestamp when the KB was queried
    - `workflows` WorkflowMetadata[] — Workflows that match this ticket
      - `workflow_id` string, required — Workflow instance ID
      - `name` string, required — Workflow name
      - `description` string, nullable — Workflow description
      - `workflow_target` string, nullable — Workflow template ID (e.g., 'app-access', 'idp-password-reset')
    - `tags` TagResponse[]
      - `id` integer, required
      - `desk_id` string, required
      - `name` string, required
      - `color` string, nullable
      - `description` string, nullable
      - `system_tag` boolean, nullable
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `related_asset_ids` string[], nullable — List of asset IDs (UUIDs) associated with this ticket
    - `thread_id` string, uuid, nullable — Thread ID for the ticket conversation
    - `response_sla_deadline` string, date-time, nullable
    - `response_sla_completed_at` string, date-time, nullable
    - `resolution_sla_deadline` string, date-time, nullable
    - `resolution_sla_completed_at` string, date-time, nullable
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/harmony/apis/service-desk.md) · [All operations](https://skmtc.net/harmony/apis/service-desk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harmony/service-desk/revisions/abcdc6e980f3/schema)