API reference
Platform
- Search
- Users
- Teams
- Tickets
- Tags
- Ticket tags
- Accounts
- Forms
- Comments
- Emoji actions
- Custom object fields
- Custom objects
- Object records
- Views
- Views types
- Draft tickets
- Storage
- Reactions
Workflows
- Workflows
Apps platform
- App creation
- App installation
- App uninstallation
- App reinstallation
- Incoming webhook
Search
Entity search
Search for tickets, accounts, and comments
GET
/
v1
/
search
/
{collection}
curl --request GET \
--url https://platform.thena.ai/v1/search/{collection} \
--header 'x-api-key: <api-key>'
{
"result": {
"facet_counts": [
{}
],
"found": 123,
"hits": [
{
"document": {
"id": "<string>",
"ticketIdentifier": "<string>",
"title": "<string>",
"ticketId": 123,
"description": "<string>",
"source": "<string>",
"accountId": "<string>",
"status": "<string>",
"statusId": "<string>",
"priority": "<string>",
"priorityId": "<string>",
"storyPoints": 123,
"account": "<string>",
"teamId": "<string>",
"teamName": "<string>",
"teamIdentifier": "<string>",
"subTeamId": "<string>",
"subTeamName": "<string>",
"subTeamIdentifier": "<string>",
"isPrivate": true,
"typeId": "<string>",
"type": "<string>",
"assignedAgent": "<string>",
"assignedAgentId": "<string>",
"assignedAgentEmail": "<string>",
"requestorEmail": "<string>",
"customerContactId": "<string>",
"customerContactFirstName": "<string>",
"customerContactLastName": "<string>",
"customerContactEmail": "<string>",
"submitterEmail": "<string>",
"customFieldValues": [
"<string>"
],
"deletedAt": "<string>",
"archivedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"formId": "<string>",
"aiGeneratedTitle": "<string>",
"aiGeneratedSummary": "<string>",
"sentiment": "<string>",
"sentimentId": "<string>",
"uid": "<string>",
"metadata": "<string>",
"organizationId": "<string>",
"organizationUid": "<string>",
"formUid": "<string>",
"formName": "<string>",
"accountName": "<string>",
"accountPrimaryDomain": "<string>",
"accountWebsite": "<string>",
"accountAnnualRevenue": "<string>",
"accountEmployees": "<string>",
"accountOwnerId": "<string>",
"accountOwnerEmail": "<string>",
"accountOwnerName": "<string>",
"accountOwnerUserType": "<string>",
"accountOwnerStatus": "<string>",
"accountOwnerTimezone": "<string>",
"teamUid": "<string>",
"subTeamUid": "<string>",
"assignedAgentName": "<string>",
"statusName": "<string>",
"statusUid": "<string>",
"priorityUid": "<string>",
"priorityName": "<string>",
"typeName": "<string>",
"typeUid": "<string>",
"typeIcon": "<string>",
"typeColor": "<string>",
"isEscalated": true,
"isDraft": true,
"sentimentUid": "<string>",
"sentimentName": "<string>",
"dueDate": "<string>",
"contactEmail": "<string>",
"contactName": "<string>",
"contactPhone": "<string>",
"slaTotalResolutionTimeStatus": "<string>",
"slaTotalResolutionTimeScheduledAt": "<string>",
"slaTotalResolutionTimeBreachedAt": "<string>",
"slaTotalResolutionTimeAchievedAt": "<string>",
"slaTotalResolutionTimePausedAt": "<string>",
"slaTotalResolutionTimeResumedAt": "<string>",
"slaTotalResolutionTimeCancelledAt": "<string>",
"slaTotalResolutionTimeDurationToBreachMinutes": "<string>",
"slaTotalResolutionTimePausedDurationMinutes": "<string>",
"slaTotalResolutionTimeNextAttemptAt": "<string>",
"slaFirstTimeResponseStatus": "<string>",
"slaFirstTimeResponseScheduledAt": "<string>",
"slaFirstTimeResponseBreachedAt": "<string>",
"slaFirstTimeResponseAchievedAt": "<string>",
"slaFirstTimeResponsePausedAt": "<string>",
"slaFirstTimeResponseResumedAt": "<string>",
"slaFirstTimeResponseCancelledAt": "<string>",
"slaFirstTimeResponseDurationToBreachMinutes": "<string>",
"slaFirstTimeResponsePausedDurationMinutes": "<string>",
"slaFirstTimeResponseNextAttemptAt": "<string>",
"slaNextTimeResponseStatus": "<string>",
"slaNextTimeResponseScheduledAt": "<string>",
"slaNextTimeResponseBreachedAt": "<string>",
"slaNextTimeResponseAchievedAt": "<string>",
"slaNextTimeResponsePausedAt": "<string>",
"slaNextTimeResponseResumedAt": "<string>",
"slaNextTimeResponseCancelledAt": "<string>",
"slaNextTimeResponseDurationToBreachMinutes": "<string>",
"slaNextTimeResponsePausedDurationMinutes": "<string>",
"slaNextTimeResponseNextAttemptAt": "<string>",
"slaUpdateTimeStatus": "<string>",
"slaUpdateTimeScheduledAt": "<string>",
"slaUpdateTimeBreachedAt": "<string>",
"slaUpdateTimeAchievedAt": "<string>",
"slaUpdateTimePausedAt": "<string>",
"slaUpdateTimeResumedAt": "<string>",
"slaUpdateTimeCancelledAt": "<string>",
"slaUpdateTimeDurationToBreachMinutes": "<string>",
"slaUpdateTimePausedDurationMinutes": "<string>",
"slaUpdateTimeNextAttemptAt": "<string>"
}
}
],
"page": 123,
"request_params": {},
"search_cutoff": true
}
}
Authorizations
Enter your API key
Path Parameters
The collection to search (tickets, comments, accounts, customer_contacts)
Available options:
tickets
, comments
, accounts
, customer_contacts
Query Parameters
The search query
Example:
"*"
Fields to query by (comma separated)
Example:
"title,description"
Enable streaming of paginated results
Example:
false
Filter by expression
Example:
"priorityName:=medium&&statusName:=resolved"
Sort by expression
Facet by fields (comma separated)
Page number
Results per page
Example:
"10"
Group by fields (comma separated)
Group limit
Fields to include in the response (comma separated)
Example:
"uid,title,statusName,createdAt,updatedAt,priorityName,ticketIdentifier"
Exclude fields (comma separated)
Response
200 - application/json
Search result
The response is of type object
.
curl --request GET \
--url https://platform.thena.ai/v1/search/{collection} \
--header 'x-api-key: <api-key>'
{
"result": {
"facet_counts": [
{}
],
"found": 123,
"hits": [
{
"document": {
"id": "<string>",
"ticketIdentifier": "<string>",
"title": "<string>",
"ticketId": 123,
"description": "<string>",
"source": "<string>",
"accountId": "<string>",
"status": "<string>",
"statusId": "<string>",
"priority": "<string>",
"priorityId": "<string>",
"storyPoints": 123,
"account": "<string>",
"teamId": "<string>",
"teamName": "<string>",
"teamIdentifier": "<string>",
"subTeamId": "<string>",
"subTeamName": "<string>",
"subTeamIdentifier": "<string>",
"isPrivate": true,
"typeId": "<string>",
"type": "<string>",
"assignedAgent": "<string>",
"assignedAgentId": "<string>",
"assignedAgentEmail": "<string>",
"requestorEmail": "<string>",
"customerContactId": "<string>",
"customerContactFirstName": "<string>",
"customerContactLastName": "<string>",
"customerContactEmail": "<string>",
"submitterEmail": "<string>",
"customFieldValues": [
"<string>"
],
"deletedAt": "<string>",
"archivedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"formId": "<string>",
"aiGeneratedTitle": "<string>",
"aiGeneratedSummary": "<string>",
"sentiment": "<string>",
"sentimentId": "<string>",
"uid": "<string>",
"metadata": "<string>",
"organizationId": "<string>",
"organizationUid": "<string>",
"formUid": "<string>",
"formName": "<string>",
"accountName": "<string>",
"accountPrimaryDomain": "<string>",
"accountWebsite": "<string>",
"accountAnnualRevenue": "<string>",
"accountEmployees": "<string>",
"accountOwnerId": "<string>",
"accountOwnerEmail": "<string>",
"accountOwnerName": "<string>",
"accountOwnerUserType": "<string>",
"accountOwnerStatus": "<string>",
"accountOwnerTimezone": "<string>",
"teamUid": "<string>",
"subTeamUid": "<string>",
"assignedAgentName": "<string>",
"statusName": "<string>",
"statusUid": "<string>",
"priorityUid": "<string>",
"priorityName": "<string>",
"typeName": "<string>",
"typeUid": "<string>",
"typeIcon": "<string>",
"typeColor": "<string>",
"isEscalated": true,
"isDraft": true,
"sentimentUid": "<string>",
"sentimentName": "<string>",
"dueDate": "<string>",
"contactEmail": "<string>",
"contactName": "<string>",
"contactPhone": "<string>",
"slaTotalResolutionTimeStatus": "<string>",
"slaTotalResolutionTimeScheduledAt": "<string>",
"slaTotalResolutionTimeBreachedAt": "<string>",
"slaTotalResolutionTimeAchievedAt": "<string>",
"slaTotalResolutionTimePausedAt": "<string>",
"slaTotalResolutionTimeResumedAt": "<string>",
"slaTotalResolutionTimeCancelledAt": "<string>",
"slaTotalResolutionTimeDurationToBreachMinutes": "<string>",
"slaTotalResolutionTimePausedDurationMinutes": "<string>",
"slaTotalResolutionTimeNextAttemptAt": "<string>",
"slaFirstTimeResponseStatus": "<string>",
"slaFirstTimeResponseScheduledAt": "<string>",
"slaFirstTimeResponseBreachedAt": "<string>",
"slaFirstTimeResponseAchievedAt": "<string>",
"slaFirstTimeResponsePausedAt": "<string>",
"slaFirstTimeResponseResumedAt": "<string>",
"slaFirstTimeResponseCancelledAt": "<string>",
"slaFirstTimeResponseDurationToBreachMinutes": "<string>",
"slaFirstTimeResponsePausedDurationMinutes": "<string>",
"slaFirstTimeResponseNextAttemptAt": "<string>",
"slaNextTimeResponseStatus": "<string>",
"slaNextTimeResponseScheduledAt": "<string>",
"slaNextTimeResponseBreachedAt": "<string>",
"slaNextTimeResponseAchievedAt": "<string>",
"slaNextTimeResponsePausedAt": "<string>",
"slaNextTimeResponseResumedAt": "<string>",
"slaNextTimeResponseCancelledAt": "<string>",
"slaNextTimeResponseDurationToBreachMinutes": "<string>",
"slaNextTimeResponsePausedDurationMinutes": "<string>",
"slaNextTimeResponseNextAttemptAt": "<string>",
"slaUpdateTimeStatus": "<string>",
"slaUpdateTimeScheduledAt": "<string>",
"slaUpdateTimeBreachedAt": "<string>",
"slaUpdateTimeAchievedAt": "<string>",
"slaUpdateTimePausedAt": "<string>",
"slaUpdateTimeResumedAt": "<string>",
"slaUpdateTimeCancelledAt": "<string>",
"slaUpdateTimeDurationToBreachMinutes": "<string>",
"slaUpdateTimePausedDurationMinutes": "<string>",
"slaUpdateTimeNextAttemptAt": "<string>"
}
}
],
"page": 123,
"request_params": {},
"search_cutoff": true
}
}
Assistant
Responses are generated using AI and may contain mistakes.