Search tickets

Tickets in a queue or matching a text search, with status, priority, category and assignee.

GET https://cotlet.dev/api/v1/happyfox/tickets/search

read

Returns tickets without their updates, newest first. Pass queue_id from list_queues to read one queue, query for words in the subject or text, or both. Pages hold up to 50 tickets; pass next_cursor back as cursor for the next page. Use get_ticket for the full thread.

Parameters

Parameters: search_tickets
NameTypeDescription
queue_id integer integer Queue ID from list_queues. Default: All Tickets.
query string string Words to find in the subject or text.
limit integer integer 1 to 50. Default: 25.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/happyfox/tickets/search \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("happyfox", "search_tickets")
Node.js
const result = await cotlet.call('happyfox', 'search_tickets');
CLI
cotlet call happyfox search_tickets

Example response

JSON

{
  "tickets": [
    {
      "ticket_id": 2038,
      "subject": "Refund for double charge",
      "status": "New",
      "priority": null,
      "category": "Billing",
      "contact": "Maya Brandt",
      "assignee": null,
      "tags": [],
      "updated_at": "2026-10-19T06:41:00Z"
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.