List tickets

Lists tickets with optional filtering and pagination

List tickets

get

Lists tickets with optional filtering and pagination

Query parameters

pageinteger · min: 1OptionalDefault: 1

page_sizeinteger · min: 1 · max: 200OptionalDefault: 25

sort_bystring · enumOptionalDefault: created_atPossible values:

sort_directionstring · enumOptionalDefault: descPossible values:

titlestring · nullableOptional

descriptionstring · nullableOptional

reporterstring[] · nullableOptional

assigneestring[] · nullableOptional

Use 'UNASSIGN' for unassigned

desk_idstring[] · nullableOptional

subdesk_idstring[] · nullableOptional

Filter by subdesk (team) IDs

tag_idsinteger[] · nullableOptional

tag_namesstring[] · nullableOptional

vip_reporterboolean · nullableOptional

Filter tickets by VIP status of the reporter employee

location_reporterstring[] · nullableOptional

Filter tickets by location of the reporter employee

Responses

200

Successful Response

application/json

total_countintegerRequired

422

Validation Error

application/json

get/api/v1/tickets/

HTTPcURLJavaScriptPython

GET /service-desk/api/v1/tickets/ HTTP/1.1
Host: api.harmony.io
Accept: */*

{
  "items": [
    {
      "id": "text",
      "title": "text",
      "description": "text",
      "ticket_type": "request",
      "priority": "low",
      "source": "slack",
      "status": "open",
      "reporter": "text",
      "created_by": "text",
      "assignee": "text",
      "desk_id": "text",
      "subdesk_id": "text",
      "created_at": "2026-08-11T06:10:45.524Z",
      "updated_at": "2026-08-11T06:10:45.524Z",
      "custom_fields": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "ticket_metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "kb_resolution": {
        "answer_summary": "text",
        "sources": [
          {
            "url": "text",
            "title": "text"
          }
        ],
        "chunks_count": 1,
        "confidence": 1,
        "queried_at": "2026-08-11T06:10:45.524Z"
      },
      "workflows": [
        {
          "workflow_id": "text",
          "name": "text",
          "description": "text",
          "workflow_target": "text"
        }
      ],
      "tags": [
        {
          "id": 1,
          "desk_id": "text",
          "name": "text",
          "color": "text",
          "description": "text",
          "system_tag": true,
          "created_at": "2026-08-11T06:10:45.524Z",
          "updated_at": "2026-08-11T06:10:45.524Z"
        }
      ],
      "related_asset_ids": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "thread_id": "123e4567-e89b-12d3-a456-426614174000",
      "response_sla_deadline": "2026-08-11T06:10:45.524Z",
      "response_sla_completed_at": "2026-08-11T06:10:45.524Z",
      "resolution_sla_deadline": "2026-08-11T06:10:45.524Z",
      "resolution_sla_completed_at": "2026-08-11T06:10:45.524Z"
    }
  ],
  "total_count": 1
}