List tickets
Tickets in the Mailbox by section, channel, type, owner or tag, with status, order number and reply count.
GET https://cotlet.dev/api/v1/edesk/tickets
read
Lists tickets the way the Mailbox shows them. status picks the section: new (never answered), to_do, waiting, snoozed, resolved or spam. query searches customer details (name, email, phone) and order details (product name, SKU, order ID) like the Search bar. type is the ticket type as eDesk names it, for example Shipping query, Return request, Cancellation or Negative feedback. last_updated_at is the time of the latest message on the ticket. Pass next_cursor back as cursor for the next page. Use ticket_id with get_ticket, reply_to_ticket and update_ticket.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | new, to_do, waiting, snoozed, resolved or spam. Default: to_do. |
| query string | string | Search text: customer name, email, phone, product name, SKU or order ID. |
| type string | string | Ticket type as eDesk names it, for example Shipping query, Return request, Cancellation, Negative feedback. |
| channel_id integer | integer | Channel ID from list_channels. |
| owner_id integer | integer | User ID from list_users. Only tickets owned by this user. |
| tag string | string | Only tickets with this tag. |
| updated_before date | date | Only tickets whose latest message is before this date (YYYY-MM-DD). |
| limit integer | integer | How many items to return per page. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/edesk/tickets?status=waiting&updated_before=2026-10-13" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("edesk", "list_tickets", {"status":"waiting","updated_before":"2026-10-13"})const result = await cotlet.call('edesk', 'list_tickets', {"status":"waiting","updated_before":"2026-10-13"});cotlet call edesk list_tickets --data '{"status":"waiting","updated_before":"2026-10-13"}'Example response
{
"tickets": [
{
"ticket_id": 48199,
"subject": "Parcel has not arrived",
"status": "waiting",
"type": "Shipping query",
"channel": "Amazon UK - Brightside Home",
"customer": "Emma Wright",
"owner": null,
"tags": [],
"replies": 1,
"order_number": "026-3350917-1184029",
"last_updated_at": "2026-10-12 08:15:00"
},
{
"ticket_id": 48177,
"subject": "Item arrived with a cracked lid",
"status": "waiting",
"type": "Return request",
"channel": "eBay UK - Brightside Home",
"customer": "Tom Hale",
"owner": "Marco Silva",
"tags": [
"Returns"
],
"replies": 2,
"order_number": "15-11874-62103",
"last_updated_at": "2026-10-11 16:40:00"
}
],
"next_cursor": null
}