/tickets/{id}

Returns a Ticket object with the given id.

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Path parameters

idstringRequiredformat: "uuid"

Headers

X-Account-TokenstringRequired
Token identifying the end user.

Query parameters

expandenumOptional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
include_remote_databooleanOptional

Whether to include the original data Merge fetched from the third-party to produce these models.

include_remote_fieldsbooleanOptional
Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.
include_shell_databooleanOptional

Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).

remote_fieldsenumOptional

Deprecated. Use show_enum_origins.

show_enum_originsenumOptional
A comma separated list of enum field names for which you'd like the original values to be returned, instead of Merge's normalized enum values. [Learn more](https://help.merge.dev/en/articles/8950958-show_enum_origins-query-parameter)

Response

idstring or nullRead-onlyformat: "uuid"
remote_idstring or null

The third-party API ID of the matching object.

created_atdatetime or nullRead-only
The datetime that this object was created by Merge.
modified_atdatetime or nullRead-only
The datetime that this object was modified by Merge.
namestring or null
The ticket's name.
assigneeslist of strings or null
The individual `Users` who are assigned to this ticket. This does not include `Users` who just have view access to this ticket. To fetch all `Users` and `Teams` that can access the ticket, use the `GET /tickets/{ticket_id}/viewers` [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
assigned_teamslist of strings or null
The `Teams` that are assigned to this ticket. This does not include `Teams` who just have view access to this ticket. To fetch all `Users` and `Teams` that can access this ticket, use the `GET /tickets/{ticket_id}/viewers` [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
creatorstring or nullformat: "uuid"
The user who created this ticket.
due_datedatetime or null
The ticket's due date.
statusenum or null
The current status of the ticket. * `OPEN` - OPEN * `CLOSED` - CLOSED * `IN_PROGRESS` - IN_PROGRESS * `ON_HOLD` - ON_HOLD
Allowed values:
descriptionstring or null

The ticket’s description. HTML version of description is mapped if supported by the third-party platform.

collectionslist of strings or null

The Collections that this Ticket is included in.

ticket_typestring or null

The sub category of the ticket within the 3rd party system. Examples include incident, task, subtask or to-do.

accountstring or nullformat: "uuid"
The account associated with the ticket.
contactstring or nullformat: "uuid"
The contact associated with the ticket.
parent_ticketstring or nullformat: "uuid"
The ticket's parent ticket.
attachmentslist of strings or null
access_levelenum or null
The description of who is able to access a given ticket, or where access is inherited from. * `COMPANY` - COMPANY * `PUBLIC` - PUBLIC * `PRIVATE` - PRIVATE * `COLLECTION` - COLLECTION
Allowed values:
permissionslist of objects or nullRead-only
tagslist of strings or null
roleslist of strings or null
ticket_urlstring or nullformat: "uri"<=2000 characters
The 3rd party url of the Ticket.
priorityenum or null
The priority or urgency of the Ticket. * `URGENT` - URGENT * `HIGH` - HIGH * `NORMAL` - NORMAL * `LOW` - LOW
Allowed values:
remote_created_atdatetime or null
When the third party's ticket was created.
remote_updated_atdatetime or null
When the third party's ticket was updated.
completed_atdatetime or null
When the ticket was completed.
remote_was_deletedboolean or nullRead-only
Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/).
field_mappingsobject or nullRead-only
remote_datalist of objects or nullRead-only
remote_fieldslist of objects or nullRead-only
<MergeSupportedFieldsByIntegrationWidget requestType="GET" data="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" />