List Tickets ​
Endpoint ​
GET /unified/ticketing/tickets
Integrations supported
- Airtable
- Asana
- Azure DevOps
- Basecamp
- Bitbucket
- ClickUp
- Freshdesk
- GitLab
- Gorgias
- Help Scout
- HubSpot
- Intercom
- Jira
- Linear
- Monday.com
- Salesforce
- Shortcut
- Trello
- YouTrack
- Zendesk
- Zoho Desk
Partial response integrations
For partial response integrations, you will need to fetch the individual resource using the "get" endpoint to get the full response object.
- Zoho Desk
Query parameters ​
Refer Specifying query parameters in Truto APIs
The ID of the integrated account to use for the request.
62f44730-dd91-461e-bd6a-aedd9e0ad79d
The format of the response.
unified
will return the response with unified mappings applied.raw
will return the raw response from the remote API.normalized
will apply the unified mappings and return the data in a normalized format.
Defaults to unified
.
unified
raw
normalized
unified
By default the result
attribute is an array of objects. This parameter allows you to specify a field in each result
objects to use as key, which transforms the result
array into an object with the array items keyed by the field. This is useful for when you want to use the result as a lookup table.
id
Ignores the limit
query parameter.
Excludes the remote_data
attribute from the response.
Array of fields to exclude from the response.
truto_exclude_fields[]=id&truto_exclude_fields[]=name
Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.
remote_query[foo]=bar
Collections associated with the ticket
Integration specific notes
- Help ScoutCollections associated with the ticket
- GorgiasCollections associated with the ticket
- LinearCollections associated with the ticket
- JiraCollections associated with the ticket
- BasecampCollections associated with the ticket
- AirtableCollections associated with the ticket
- Monday.comCollections associated with the ticket
- AsanaCollections associated with the ticket. One of collections, workspace or tags is required.
- YouTrackCollections associated with the ticket
- BitbucketThe unique identifier for a ticket
Required in
- Airtable
- Basecamp
- Bitbucket
- Monday.com
Supported in
- Asana
- Gorgias
- Help Scout
- HubSpot
- Jira
- Linear
- Shortcut
- YouTrack
Time at which the ticket was last updated
Supported in
- Asana
- Azure DevOps
- ClickUp
- Freshdesk
- Help Scout
- HubSpot
- Intercom
- Jira
- Linear
- Shortcut
- YouTrack
- Zendesk
Tags associated with the ticket
Integration specific notes
- AsanaTags associated with the ticket. One of collections, workspace or tags is required.
- ShortcutTags associated with the ticket
- YouTrackTags associated with the ticket
Supported in
- Asana
- Azure DevOps
- ClickUp
- Freshdesk
- GitLab
- Help Scout
- Intercom
- Jira
- Linear
- Shortcut
- Trello
- YouTrack
- Zendesk
The name of the ticket
Supported in
- Asana
- Azure DevOps
- GitLab
- Help Scout
- Jira
- Linear
- Shortcut
- Trello
- YouTrack
Integration specific notes
- Help ScoutThe unique identifier for a user
- ClickUpThe unique identifier for the users assigned to the ticket
- LinearThe unique identifier for the users assigned to the ticket
- ZendeskThe unique identifier for the users assigned to the ticket
- FreshdeskThe unique identifier for the users assigned to the ticket
- JiraThe unique identifier for the users assigned to the ticket
Supported in
- ClickUp
- Freshdesk
- Help Scout
- Jira
- Linear
- Zendesk
The status of the ticket
Integration specific notes
- BasecampStatus associated with the ticket. Required if collection type is "kanban_board"
- YouTrackThe status of the ticket
Supported in
- Azure DevOps
- Basecamp
- ClickUp
- Freshdesk
- GitLab
- Help Scout
- Intercom
- Jira
- Linear
- Monday.com
- Shortcut
- Trello
- YouTrack
- Zendesk
The unique identifier for a status
The name of the status
active
all
archived
closed
completed
deleted
open
pending
resolved
spam
An optional ticket number maintained by the system.
Supported in
- GitLab
- Gorgias
- Help Scout
- YouTrack
Description of the ticket
Supported in
- GitLab
- Help Scout
- Jira
- Linear
- Shortcut
- Trello
- YouTrack
Time at which the ticket was created
Supported in
- Azure DevOps
- ClickUp
- Freshdesk
- Help Scout
- Intercom
- Jira
- Linear
- Shortcut
- YouTrack
- Zendesk
The unique identifier for a contact
Supported in
- Gorgias
The field to sort the resource by. Should be in format { fieldName: direction }
. The direction can be asc
or desc
.
Supported in
- Gorgias
- YouTrack
The sort order of the tickets by created date.
asc
desc
Supported in
- Gorgias
- YouTrack
The sort order of the tickets by updated date.
asc
desc
Supported in
- Gorgias
- YouTrack
Time at which the ticket was completed
asc
desc
Supported in
- YouTrack
Collections associated with the ticket
asc
desc
Supported in
- YouTrack
The unique identifier for a collection
The name of the collection
The name of the ticket
asc
desc
Supported in
- YouTrack
An optional ticket number maintained by the system.
asc
desc
Supported in
- YouTrack
User or contact who created the ticket
asc
desc
Supported in
- YouTrack
The unique identifier for a user
The name of the user
The type of the user
user
contact
Users assigned to the ticket
asc
desc
Supported in
- YouTrack
The unique identifier for a user
The name of the user
The first name of the user
The last name of the user
The user's email addresses
The user's email address
The type of email address
Type of the ticket
asc
desc
Supported in
- YouTrack
The unique identifier for a ticket type
The name of the ticket type
The status of the ticket
asc
desc
Supported in
- YouTrack
The unique identifier for a status
The name of the status
active
closed
open
pending
spam
resolved
archived
deleted
completed
Priority of the ticket
asc
desc
Supported in
- YouTrack
The unique identifier for a priority
The name of the priority
The unique identifier for the workspace
Required in
- Airtable
- Azure DevOps
- ClickUp
Due date of the ticket
Supported in
- ClickUp
- Jira
- Linear
- Monday.com
- Shortcut
Time at which the ticket was completed
Supported in
- Asana
- Azure DevOps
- ClickUp
- Jira
- Linear
- Shortcut
- YouTrack
The unique identifier for the user who created the ticket
Supported in
- Linear
Priority of the ticket
Supported in
- Azure DevOps
- Intercom
- Jira
- Linear
- YouTrack
The unique identifier for a priority
The name of the priority
The side-loaded resources to include in the response. Only value supported is users
Supported in
- Zendesk
Type of the ticket
Supported in
- Azure DevOps
- Jira
- Shortcut
- YouTrack
The unique identifier for a ticket type
The name of the ticket type
Parent ticket associated for the ticket.
Supported in
- Azure DevOps
- Jira
The unique identifier for the parent_ticket
The name of the ticket
Workspace associated with the ticket
Integration specific notes
- BasecampWorkspace associated with the ticket.
- AsanaWorkspace associated with the ticket. If provided, assignee should also be provided.
- BitbucketThe unique identifier for a workspace
Required in
- Basecamp
- Bitbucket
- GitLab
Supported in
- Asana
- Trello
The unique identifier for the workspace.
The name of the workspace
The name of the user assigned to the ticket
Supported in
- Monday.com
- Trello
Integration specific notes
- Azure DevOpsThe user assigned to the ticket
- AsanaThe Users assigned to the ticket. Required if workspace is ALSO provided.
Supported in
- Asana
- Azure DevOps
The unique identifier for the users assigned to the ticket.
The name of the user
The email of the user
Team associated with the ticket.
Supported in
- Asana
The unique identifier for the team.
Custom fields associated with the ticket. If provided, workspace should also be provided.
Supported in
- Asana
The unique identifier for the custom_field
Users assigned to the ticket
Supported in
- GitLab
- Shortcut
- YouTrack
User or contact who created the ticket
Supported in
- GitLab
- Shortcut
- YouTrack
The unique identifier for a user
The name of the user
The type of the user
contact
user
The username of the user who created the ticket
Attachments associated with the ticket
Supported in
- YouTrack
Response Body ​
List of Tickets
The unique identifier for a ticket
Supported in
- Airtable
- Asana
- Azure DevOps
- Basecamp
- Bitbucket
- ClickUp
- Freshdesk
- GitLab
- Gorgias
- Help Scout
- HubSpot
- Intercom
- Jira
- Linear
- Monday.com
- Salesforce
- Shortcut
- Trello
- YouTrack
- Zendesk
- Zoho Desk
The name of the ticket
Supported in
- Asana
- Azure DevOps
- Basecamp
- Bitbucket
- ClickUp
- Freshdesk
- GitLab
- Gorgias
- Help Scout
- HubSpot
- Intercom
- Jira
- Linear
- Monday.com
- Salesforce
- Shortcut
- Trello
- YouTrack
- Zendesk
- Zoho Desk
An optional ticket number maintained by the system.
Supported in
- GitLab
- Gorgias
- Help Scout
- Linear
- Salesforce
- Shortcut
- YouTrack
Users assigned to the ticket
Supported in
- Asana
- Azure DevOps
- Basecamp
- Bitbucket
- ClickUp
- Freshdesk
- GitLab
- Gorgias
- Help Scout
- HubSpot
- Intercom
- Jira
- Linear
- Salesforce
- Shortcut
- Trello
- YouTrack
- Zendesk
- Zoho Desk
The unique identifier for a user
The name of the user
The first name of the user
The last name of the user
The user's email addresses
The user's email address
The type of email address
The status of the ticket
Supported in
- Azure DevOps
- Basecamp
- Bitbucket
- ClickUp
- Freshdesk
- GitLab
- Gorgias
- Help Scout
- HubSpot
- Intercom
- Jira
- Linear
- Monday.com
- Salesforce
- Shortcut
- Trello
- YouTrack
- Zendesk
- Zoho Desk
The unique identifier for a status
The name of the status
active
closed
open
pending
spam
resolved
archived
deleted
completed
User or contact who created the ticket
Supported in
- Azure DevOps
- Basecamp
- Bitbucket
- ClickUp
- GitLab
- Gorgias
- Help Scout
- Intercom
- Jira
- Linear
- Monday.com
- Salesforce
- Shortcut
- YouTrack
- Zendesk
The unique identifier for a user
The name of the user
The type of the user
user
contact
Due date of the ticket
Supported in
- Asana
- Basecamp
- ClickUp
- Freshdesk
- GitLab
- Jira
- Linear
- Shortcut
- Trello
- Zendesk
- Zoho Desk
Description of the ticket
Supported in
- Asana
- Azure DevOps
- Basecamp
- Bitbucket
- ClickUp
- Freshdesk
- GitLab
- Gorgias
- Help Scout
- Intercom
- Jira
- Linear
- Salesforce
- Shortcut
- Trello
- YouTrack
- Zendesk
Workspace associated with the ticket
Supported in
- Azure DevOps
- Basecamp
- Bitbucket
- GitLab
- Trello
The unique identifier for a workspace
The name of the workspace
Team associated with the ticket
Supported in
- Shortcut
The unique identifier for a team
The name of the team
Collections associated with the ticket
Supported in
- Asana
- Basecamp
- Bitbucket
- ClickUp
- Help Scout
- HubSpot
- Jira
- Linear
- Monday.com
- Shortcut
- Trello
- YouTrack
The unique identifier for a collection
The name of the collection
Type of the ticket
Supported in
- Asana
- Azure DevOps
- Bitbucket
- Freshdesk
- GitLab
- Help Scout
- Jira
- Salesforce
- Shortcut
- YouTrack
- Zendesk
The unique identifier for a ticket type
The name of the ticket type
Contact associated with the ticket
Supported in
- Basecamp
- Freshdesk
- Gorgias
- Help Scout
- HubSpot
- Intercom
- Salesforce
- Zendesk
- Zoho Desk
The unique identifier for a contact
The first name of the contact
The last name of the contact
The name of the contact
The emails of the contact
The email of the contact
The type of the email
Parent ticket associated with the ticket
Supported in
- Asana
- Azure DevOps
- ClickUp
- Jira
- Monday.com
- Salesforce
- YouTrack
The unique identifier for a ticket
The name of the ticket
Attachments associated with the ticket
Supported in
- Asana
- Intercom
- Jira
- Linear
- YouTrack
The unique identifier for an attachment
The name of the attachment
The url of the attachment
Tags associated with the ticket
Supported in
- Asana
- ClickUp
- Freshdesk
- GitLab
- Gorgias
- Help Scout
- Intercom
- Jira
- Linear
- Shortcut
- Trello
- YouTrack
- Zendesk
The unique identifier for a tag
The name of the tag
Time at which the ticket was created
Supported in
- Airtable
- Asana
- Azure DevOps
- Basecamp
- Bitbucket
- ClickUp
- Freshdesk
- GitLab
- Gorgias
- Help Scout
- HubSpot
- Intercom
- Jira
- Linear
- Monday.com
- Salesforce
- Shortcut
- Trello
- YouTrack
- Zendesk
- Zoho Desk
Time at which the ticket was last updated
Supported in
- Asana
- Azure DevOps
- Basecamp
- Bitbucket
- ClickUp
- Freshdesk
- GitLab
- Gorgias
- Help Scout
- HubSpot
- Intercom
- Jira
- Linear
- Monday.com
- Salesforce
- Shortcut
- Trello
- YouTrack
- Zendesk
Time at which the ticket was completed
Supported in
- Asana
- Azure DevOps
- Basecamp
- ClickUp
- GitLab
- Gorgias
- Help Scout
- HubSpot
- Intercom
- Jira
- Linear
- Salesforce
- Shortcut
- YouTrack
- Zoho Desk
URL of the ticket
Supported in
- Asana
- Azure DevOps
- Basecamp
- Bitbucket
- GitLab
- Help Scout
- Jira
- Linear
- Monday.com
- Shortcut
- Trello
- YouTrack
- Zendesk
- Zoho Desk
Priority of the ticket
Supported in
- Azure DevOps
- Bitbucket
- ClickUp
- Freshdesk
- Gorgias
- Intercom
- Jira
- Linear
- Salesforce
- Trello
- YouTrack
- Zendesk
- Zoho Desk
The unique identifier for a priority
The name of the priority
Languages of the ticket
Supported in
- Gorgias
Whether the ticket is unread
Supported in
- Gorgias
Supported in
- Salesforce
The unique identifier for a source
The name of the source
Raw data returned from the remote API call.
The cursor to use for the next page of results. Pass this value as next_cursor
in the query parameter in the next request to get the next page of results.