Search tickets

Tickets that match a search phrase, with optional category, status, technician or date filters.

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

read

Searches the tickets you may see for a phrase and returns the matches with status, priority, category, submitter and assigned technician, without comments. Narrow the search with a category, a status, a technician or a creation date range. Use get_ticket for the full thread.

Parameters

Parameters: search_tickets
NameTypeDescription
query string required string Words to find in the ticket subject and body.
category_id integer integer Category ID from list_categories.
status string string Status name.
technician_id integer integer Only tickets assigned to this technician, from list_technicians.
created_after string string ISO date. Only tickets created after it.
created_before string string ISO date. Only tickets created before it.
limit integer integer How many to return. Default: 25.

Request

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

Example response

JSON

{
  "tickets": [
    {
      "ticket_id": 5104,
      "subject": "Still cannot log in",
      "status": "New",
      "priority": "Normal",
      "category": "Technical support",
      "submitter": "Maya Brandt",
      "assigned_to": null,
      "created_at": "2026-10-22T08:05:00Z"
    }
  ]
}

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.