Retrieves a paginated list of tickets with detailed information including related data (Optimized with DetailDTO)

Develop Env

https://dev-api-desk.tks.co.th/api

POST

/Tickets/search/detailed

Sample request:

POST /v2/tickets/search/detailed
{
"pagination": { "page": 1, "pageSize": 10 },
"filter": { "statusIds": [2001, 2002] },
"sort": { "sortField": "DateCreated", "sortDirection": "Desc" }
}

This endpoint includes:

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returns the paginated detailed tickets list

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://dev-api-desk.tks.co.th/api/Tickets/search/detailed' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '"{\"pagination\":{\"page\":1,\"pageSize\":25},\"filter\":{\"statusIds\":[2001,2002],\"priorities\":[3,4],\"dateCreatedStart\":\"2024-01-01T00:00:00Z\",\"dateCreatedEnd\":\"2024-12-31T23:59:59Z\",\"ticketOwner\":\"support@company.com\",\"subject\":\"database\"},\"sort\":{\"sortField\":\"DateCreated\",\"sortDirection\":\"Desc\",\"secondarySortField\":\"Priority\",\"secondarySortDirection\":\"Desc\"},\"includeDetails\":true}"'

Response Example

200 - Example 1

{
    "status": {
        "code": "string",
        "description": "string",
        "httpStatusCode": 0
    },
    "data": {
        "data": [
            {
                "ticketId": 12345,
                "companyId": 1,
                "ticketOwner": "support@company.com",
                "teamOwner": "IT Support",
                "subject": "Database connection issue",
                "category": "Technical",
                "subCategory": "Database",
                "statusId": 2001,
                "statusName": "Open",
                "customer": "john.doe@company.com",
                "mailTo": "john.doe@company.com",
                "mailCc": "manager@company.com,supervisor@company.com",
                "scope": "Production Environment",
                "difficulty": 3,
                "priority": 3,
                "priorityName": "High",
                "description": "We are experiencing intermittent database connection timeouts in our production environment.",
                "dateRequired": "2024-01-16T18:00:00Z",
                "dateCreated": "2024-01-15T10:30:00Z",
                "dateCompleted": "2024-01-16T15:45:00Z",
                "conversationId": "conv_abc123def456",
                "newSubject": "Database connection issue - URGENT",
                "customerCode": "CUST_001",
                "buId": 100,
                "templateId": 5,
                "agentId": 25,
                "teamId": 10,
                "departmentId": 3,
                "activitiesCount": 2,
                "approvalsCount": 1,
                "commentsCount": 5,
                "historiesCount": 8,
                "recentComments": [
                    {
                        "commentId": 100,
                        "ticketId": 12345,
                        "commentText": "I have reviewed the logs and found the root cause",
                        "commentedBy": "support@company.com",
                        "dateCommented": "2024-01-15T14:30:00Z",
                        "commentType": "Internal",
                        "isPrivate": false,
                        "attachmentsCount": 2
                    }
                ],
                "recentHistories": [
                    {
                        "historyId": 150,
                        "ticketId": 12345,
                        "createdBy": "system@company.com",
                        "dateCreated": "2024-01-15T10:30:00Z",
                        "historyType": 12001,
                        "infoSummary": "Ticket status changed from New to Open"
                    }
                ],
                "recentActivities": [
                    {
                        "activityId": 200,
                        "ticketId": 12345,
                        "subject": "Database analysis and troubleshooting",
                        "description": "Performed comprehensive analysis of database logs to identify connection timeout patterns",
                        "dateCreated": "2024-01-15T11:00:00Z",
                        "activityOwner": "support@company.com",
                        "activityType": 13001
                    }
                ],
                "approvals": [
                    {
                        "approvalId": 50,
                        "ticketId": 12345,
                        "createdBy": "manager@company.com",
                        "dateCreated": "2024-01-15T12:00:00Z",
                        "statusId": 3001,
                        "description": "Approval required for system maintenance window scheduled for tonight"
                    }
                ]
            }
        ],
        "currentPage": 0,
        "pageSize": 0,
        "totalCount": 0,
        "totalPages": 0,
        "hasNextPage": true,
        "hasPreviousPage": true,
        "itemCount": 0,
        "startItemNumber": 0,
        "endItemNumber": 0
    },
    "success": true,
    "pagination": {
        "page": 0,
        "pageSize": 0,
        "totalItems": 0,
        "totalPages": 0
    }
}

Modified at 2025-10-23 15:36:11

Gets the total count of tickets matching the specified filter criteria

Retrieves a paginated list of tickets with advanced filtering and sorting capabilities (Optimized with DTO)