List tickets
Email tickets from a folder, with status, priority, assignee and department.
MCP tool tidio_read → list_tickets
read
Lists tickets of one Inbox folder: unassigned, my_open or solved. Each ticket has an ID, subject, contact, status (open, pending or solved), priority (low, normal or urgent), assignee and department. Messages are not included; use get_ticket for them. Pages hold up to 100 tickets; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| folder enum | enum | unassigned, my_open or solved. Default: unassigned. |
| status enum | enum | open, pending or solved. Default: any. |
| limit integer | integer | 1 to 100. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tidio_read",
"arguments": {
"operation": "list_tickets",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"tickets": [
{
"ticket_id": 10477,
"subject": "Charged twice for order 2290",
"contact_email": "mark.dole@example.com",
"status": "open",
"priority": "normal",
"assignee": null,
"department": null
},
{
"ticket_id": 10482,
"subject": "When does my order ship?",
"contact_email": "mark.dole@example.com",
"status": "open",
"priority": "normal",
"assignee": null,
"department": null
}
],
"next_cursor": null
},
"isError": false
}