List tickets

ticket_list · Reads only · Markdown

Tickets, newest activity first, filtered by status, priority, requester, tag, field or contact, or as a work queue.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

Which support tickets are still waiting on us? Longest wait first.

Your agent callsticket_listFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments

{
  "view": "waiting_on_us"
}

What comes back

{
  "tickets": [
    {
      "number": 1,
      "subject": "Scratch on the Tabor's top tube",
      "status": "open",
      "priority": "high",
      "category": "Damaged delivery",
      "tags": [
        "damage"
      ],
      "requester_email": "paul.hoffmann@example.com",
      "requester_name": "Paul Hoffmann",
      "contact_id": null,
      "company_id": null,
      "source": "api",
      "channel": "api",
      "assigned_to": null,
      "waiting_on": "us",
      "sla": null,
      "merged_into": null,
      "created_at": "2026-10-14T08:00:00+00:00",
      "last_activity_at": "2026-10-14T08:00:00+00:00",
      "first_reply_at": null,
      "resolved_at": null
    }
  ],
  "count": 1
}

Use it when

To see what needs an answer (a queue like waiting_on_us or overdue), or one customer's tickets.

What it does

Tickets, newest activity first, by status (default: open and pending), priority, requester, tag, custom field, CRM contact or company, words in the subject or request, or activity since a time. A view gives a work queue instead: waiting_on_us (open, no reply since the customer last wrote; longest waiting first), waiting_on_customer (pending), overdue (an SLA target missed; most overdue first), at_risk (an SLA target due within within_minutes), unassigned, or mine (assigned to the calling bot). Free.

What comes back

Up to 100 tickets, each with its number, subject, status, priority, category, tags, requester, contact and company, channel, assignee, waiting_on, SLA state and times, and how many. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`view`	string	One of: unassigned,mine,waiting_on_us,waiting_on_customer,overdue,at_risk.
`status`	string	One of: open,pending,resolved,all.
`priority`	string	One of: low,normal,high,urgent.
`requester`	string	Up to 254 characters.
`query`	string	Up to 200 characters.
`tag`	string	Up to 40 characters.
`fields`	object	Only tickets with these custom field values, e.g. {"order_id": "1042"}.
`contact_id`	integer	At least 1.
`company_id`	integer	At least 1.
`since`	string	ISO 8601: activity at or after this time. Up to 40 characters.
`within_minutes`	integer	1 to 10,080. Default: 60.
`limit`	integer	1 to 100. Default: 25.

The call

Over MCP, call ticket_list on https://api.conecto.chat/mcp/helpdesk. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/ticket_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"view":"waiting_on_us"}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`invalid_input`400	since is not an ISO 8601 time.	Send it like 2026-10-12T09:00:00Z.

More Help desk tools

All 13 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md

List tickets

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Help desk tools

Give this to your agent.