---
title: "Search tickets"
method: GET
path: "/v1/Tickets"
tags: ["Tickets"]
---

# Search tickets

`GET /v1/Tickets`

Search for one or more tickets.

## Query parameters

- `search.ticket_id` integer[]
- `search.description` string[]
- `search.created_date_start` string, date-time
- `search.created_date_end` string, date-time
- `search.customer_id` integer[]
- `search.resolution` string[]
- `search.ticket_type_id` integer[]
- `search.ticket_step_id` integer[]
- `search.assigned_user_id` integer[]
- `search.assigned_group_id` integer[]
- `search.priority` string[]
- `search.contact_name` string[]
- `search.contact_phone` string[]
- `search.contact_email` string[]
- `search.additional_contact_emails` string
- `search.admin_ccs` string
- `search.custom_status` string[]
- `search.created_by` integer[]
- `search.due_date_start` string, date-time
- `search.due_date_end` string, date-time
- `search.status` 'OPEN' | 'INWORK' | 'CLOSED' | 'PENDING_CANCELLATION' | 'CANCELED' | 'PENDING_CLOSE' | 'PENDING'
- `search.modified_date_start` string, date-time
- `search.modified_date_end` string, date-time
- `search.modified_by` integer[]
- `search.page_size` integer
- `search.page` integer
- `search.sort` string

## Response `200`

OK

- RevWebAPIModelsGetOrSearchOfRevAppSearchModelsResponseOfRevAppModelsTicket
  - `ok` boolean
  - `has_more` boolean — Helper for pagination. Indicates there are more records returned.
  - `record_count` integer — Total number of records found by the search.
  - `records` RevAppModelsTicket[] — List of records returned.
    - `ticket_id` integer — Primary identifier for this ticket.
    - `description` string — Description of the issue.
    - `status` 'OPEN' | 'INWORK' | 'CLOSED' | 'PENDING_CANCELLATION' | 'CANCELED' | 'PENDING_CLOSE' | 'PENDING' — Current status of the ticket.
    - `resolution` string — Explanation of how the issue was resolved.
    - `ticket_type_id` integer — Foreign identifier indicating the type of ticket.
    - `ticket_step_id` integer — Foreign identifier indicating the step being performed to solve the issue.
    - `assigned_user_id` integer — Foreign identifier indicating the user who is assigned to this ticket.
    - `assigned_group_id` integer — Foreign identifier indicating the group who is assigned to this ticket.
    - `customer_id` integer — Foreign identifier indicating the customer who has the issue. Can be set to 0 (zero) or omitted to indicate ticket is not linked to an account.
    - `service_id` integer — Foreign identifier indicating the associated line of service. Can be set to 0 (zero) or omitted to indicate ticket is not linked to a service.
    - `priority_id` integer — Foreign identifier indicating the priority given to this ticket.
    - `contact_name` string — Name of the primary contact on the customer side.
    - `contact_phone` string — Phone number of the primary contact.
    - `contact_email` string — Primary contact email (or emails separated by comma).
    - `additional_contact_emails` string — Additional contact email addresses associated with a specific ticket.
    - `admin_ccs` string — Admin CCs associated with a specific ticket.
    - `custom_status` string — An open field to hold your own status code.
    - `due_date` string, date-time — Due date for ticket resolution.
    - `created_date` string, date-time — Date and time this ticket was created.
    - `closed_date` string, date-time — Date and time this ticket was closed.
    - `created_by` integer — Foreign identifier indicating the user who created this ticket.
    - `fields` RevAppModelsFieldValue[] — List of custom fields and their values.
      - `field_id` integer — Primary identifier for this custom field.
      - `label` string — User-defined identifier representing the custom field.
      - `value` string — Value of the custom field.
      - `links` RevAppComponentsLink[]
        - `rel` string
        - `href` string
    - `modified_date` string, date-time — Date and time this ticket was modified.
    - `modified_by` integer — Foreign identifier indicating the user who last modified this ticket.
    - `process_id` integer — Foreign identifier indicating what process to start with the ticket.
    - `contact_id` integer — Foreign identifier indicating which contact is associated with this ticket.
    - `provider_ticket_number` string — The provider ticket number associated with this ticket, if applicable.
    - `provider_contact_ID` integer — Foreign identifier indicating which provider contact is associated with this ticket.
    - `process_phase_id` integer — Foreign identifier indicating which phase of the current process this ticket is in.
    - `creation_source` string — Enumerated value indicating creation source of ticket (Rev.io, Agent Portal, etc.).
    - `links` RevAppComponentsLink[]
      - `rel` string
      - `href` string

## Other responses

- `500` — InternalServerError

---

[API](https://skmtc.net/rev-io/apis/rev-io-api.md) · [All operations](https://skmtc.net/rev-io/apis/rev-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rev-io/rev-io-api/revisions/135571434f6c/schema)