---
title: "List support tickets"
method: GET
path: "/tickets"
---

# List support tickets

`GET /tickets`

## Query parameters

- `filter[ticket_id]` integer
- `filter[created]` string, date-time
- `filter[updated]` string, date-time
- `filter[type]` 'problem' | 'task' | 'incident' | 'question'
- `filter[priority]` 'low' | 'normal' | 'high' | 'urgent'
- `filter[status]` 'closed' | 'deleted' | 'hold' | 'new' | 'open' | 'pending' | 'solved'
- `filter[requester_id]` string, uuid
- `filter[submitter_id]` string, uuid
- `filter[assignee_id]` string, uuid
- `filter[has_incidents]` boolean
- `filter[due]` string, date-time
- `search` string
- `page` integer

## Response `200`

The list of tickets.

- object
  - `count` integer — Total number of results.
  - `tickets` Ticket[] — Array of support tickets.
    - `ticket_id` integer — The ID of the ticket.
    - `created` string, date-time — The time when the support ticket was created.
    - `updated` string, date-time — The time when the support ticket was updated.
    - `type` 'problem' | 'task' | 'incident' | 'question' — A type of the ticket.
    - `subject` string — A title of the ticket.
    - `description` string — The description body of the support ticket.
    - `priority` 'low' | 'normal' | 'high' | 'urgent' — A priority of the ticket.
    - `followup_tid` string — Followup ticket ID. The unique ID of the ticket which this ticket is a follow-up to.
    - `status` 'closed' | 'deleted' | 'hold' | 'new' | 'open' | 'pending' | 'solved' — The status of the support ticket.
    - `recipient` string — Email address of the ticket recipient, defaults to support@upsun.com.
    - `requester_id` string, uuid — UUID of the ticket requester.
    - `submitter_id` string, uuid — UUID of the ticket submitter.
    - `assignee_id` string, uuid — UUID of the ticket assignee.
    - `organization_id` string — A reference id that is usable to find the commerce license.
    - `collaborator_ids` string[] — A list of the collaborators uuids for this ticket.
    - `has_incidents` boolean — Whether or not this ticket has incidents.
    - `due` string, date-time — A time that the ticket is due at.
    - `tags` string[] — A list of tags assigned to the ticket.
    - `subscription_id` string — The internal ID of the subscription.
    - `ticket_group` string — Maps to zendesk field 'Request group'.
    - `support_plan` string — Maps to zendesk field 'The support plan associated with this ticket.
    - `affected_url` string, url — The affected URL associated with the support ticket.
    - `queue` string — The queue the support ticket is in.
    - `issue_type` string — The issue type of the support ticket.
    - `resolution_time` string, date-time — Maps to zendesk field 'Resolution Time'.
    - `response_time` string, date-time — Maps to zendesk field 'Response Time (time from request to reply).
    - `project_url` string, url — Maps to zendesk field 'Project URL'.
    - `region` string — Maps to zendesk field 'Region'.
    - `category` 'access' | 'billing_question' | 'complaint' | 'compliance_question' | 'configuration_change' | 'general_question' | 'incident_outage' | 'bug_report' | 'onboarding' | 'report_a_gui_bug' | 'close_my_account' — Maps to zendesk field 'Category'.
    - `environment` 'env_development' | 'env_staging' | 'env_production' — Maps to zendesk field 'Environment'.
    - `ticket_sharing_status` 'ts_sent_to_platform' | 'ts_accepted_by_platform' | 'ts_returned_from_platform' | 'ts_solved_by_platform' | 'ts_rejected_by_platform' — Maps to zendesk field 'Ticket Sharing Status'.
    - `application_ticket_url` string, url — Maps to zendesk field 'Application Ticket URL'.
    - `infrastructure_ticket_url` string, url — Maps to zendesk field 'Infrastructure Ticket URL'.
    - `jira` object[] — A list of JIRA issues related to the support ticket.
      - `id` integer — The id of the query.
      - `ticket_id` integer — The id of the ticket.
      - `issue_id` integer — The issue id number.
      - `issue_key` string — The issue key.
      - `created_at` number, float — The created at timestamp.
      - `updated_at` number, float — The updated at timestamp.
    - `zd_ticket_url` string, url — URL to the customer-facing ticket in Zendesk.
  - `_links` HalLinks — Links to _self, and previous or next page, given that they exist.
    - `self` object — The cardinal link to the self resource.
      - `title` string — Title of the link
      - `href` string — URL of the link
    - `previous` object — The link to the previous resource page, given that it exists.
      - `title` string — Title of the link
      - `href` string — URL of the link
    - `next` object — The link to the next resource page, given that it exists.
      - `title` string — Title of the link
      - `href` string — URL of the link

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)