Search tickets

Tickets that match a Zendesk search query, with status, priority, requester and assignee.

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

read

Runs a Zendesk ticket search and returns the matches without comments. The query uses Zendesk's own keywords, for example status:new, status:pending updated<2026-10-13, assignee:none or requester:amy@example.com. Sorted by the field you pick, newest first by default. Pages hold up to 100 tickets; pass next_cursor back as cursor for the next page. Use get_ticket for the full thread.

Parameters

Parameters: search_tickets
NameTypeDescription
query string required string Zendesk search query, e.g. 'status:new' or 'status:pending updated<2026-10-13'.
sort_by enum enum created_at or updated_at. Default: updated_at.
sort_order enum enum asc or desc. Default: desc.
limit integer integer 1 to 100. Default: 25.
cursor string string Next page cursor from the previous call.

Request

cURL
curl "https://cotlet.dev/api/v1/zendesk/tickets/search?query=status%3Anew" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("zendesk", "search_tickets", {"query":"status:new"})
Node.js
const result = await cotlet.call('zendesk', 'search_tickets', {"query":"status:new"});
CLI
cotlet call zendesk search_tickets --data '{"query":"status:new"}'

Example response

JSON

{
  "tickets": [
    {
      "ticket_id": 48230,
      "subject": "Refund for double charge",
      "status": "new",
      "priority": null,
      "requester": "Maya Brandt",
      "assignee": null,
      "group": null,
      "tags": [],
      "created_at": "2026-10-16T06:41:00Z",
      "updated_at": "2026-10-16T06: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.