Search tickets

Tickets matching a text search or filters, newest first.

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

read

Returns tickets with subject, status, priority, assignee, tags and customer. Pass a view to read the tickets of one of your Gorgias views. Pages hold up to 50 tickets; pass next_cursor back as cursor for the next page. You see the tickets your Gorgias role can see.

Parameters

Parameters: search_tickets
NameTypeDescription
query string string Words to search for in subject and messages.
view string string Name of a Gorgias view, for example your inbox view for new tickets.
status enum enum open or closed. Default: open.
priority enum enum low, normal, high or critical.
tag string string Only tickets with this tag.
created_since date date Only tickets created on or after this date.
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/gorgias/tickets/search \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("gorgias", "search_tickets")
Node.js
const result = await cotlet.call('gorgias', 'search_tickets');
CLI
cotlet call gorgias search_tickets

Example response

JSON

{
  "tickets": [
    {
      "ticket_id": 10482,
      "subject": "Where is my order #4471?",
      "status": "open",
      "priority": "normal",
      "assignee": null,
      "tags": [
        "shipping"
      ],
      "customer": "Dana W.",
      "channel": "email",
      "created_at": "2026-10-16T21:14:00Z"
    }
  ],
  "next_cursor": "eyJwYWdlIjoyfQ"
}

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.