---
name: "ticket_report"
area: "helpdesk"
title: "Help desk report"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/ticket_report"
mcp_server: "https://api.conecto.chat/mcp/helpdesk"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/helpdesk/ticket_report"
---

# Help desk report (`ticket_report`)

How support went over the last days: volumes, backlog, response and resolution times, SLA results, ratings, and tickets by channel, priority and tag.

How support went over the last `days` (default 30): tickets opened and resolved, the backlog now (open, pending, overdue, unassigned), first-response and resolution times in minutes (median and 90th percentile), SLA targets met and breached, satisfaction ratings, and tickets by channel, priority and tag. Free.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Someone asks how support is doing, or for a monthly review.

## Say this to your agent

> How did support go last month? Response times, ratings, and what people wrote in about.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `days` | integer | no | 1 to 365. |  | `30` |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `ticket_report` on the MCP server `https://api.conecto.chat/mcp/helpdesk` with these arguments:

```json
{
  "days": 30
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/ticket_report \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days": 30}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "ticket_report",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "report": {
      "days": 30,
      "since": "2026-09-14T08:00:00+00:00",
      "opened": 1,
      "resolved": 0,
      "backlog": {
        "open": 0,
        "pending": 1,
        "overdue": 0,
        "unassigned": 1
      },
      "first_response_minutes": {
        "median": 0.0,
        "p90": 0.0,
        "count": 1
      },
      "not_answered_yet": 0,
      "resolution_minutes": {
        "median": null,
        "p90": null,
        "count": 0
      },
      "sla": {
        "first_response": {
          "met": 0,
          "breached": 0
        },
        "resolution": {
          "met": 0,
          "breached": 0
        }
      },
      "satisfaction": {
        "good": 0,
        "bad": 0,
        "score_percent": null
      },
      "by_channel": {
        "api": 1
      },
      "by_priority": {
        "high": 1
      },
      "top_tags": {
        "damage": 1
      }
    }
  }
}
```

`result`: The report: tickets opened and resolved, the backlog now, first-response and resolution times (median and 90th percentile), SLA targets met and breached, ratings, and tickets by channel, priority and tag.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [ticket_list](https://conecto.chat/tools/helpdesk/ticket_list.md): Tickets, newest activity first, filtered by status, priority, requester, tag, field or contact, or as a work queue. Free up to 1,000,000 reads a month.
- [ticket_get](https://conecto.chat/tools/helpdesk/ticket_get.md): One ticket with its request, every reply, customer message and note, its fields, SLA state and rating. Free up to 1,000,000 reads a month.
- [ticket_create](https://conecto.chat/tools/helpdesk/ticket_create.md): Opens a support ticket for a customer request; the customer is emailed only if you ask. $0.01 a call.
- [ticket_reply](https://conecto.chat/tools/helpdesk/ticket_reply.md): Emails the requester a reply in the ticket's thread, with files if needed, or adds a private note, and can set the status. $0.05 a call.
- [ticket_update](https://conecto.chat/tools/helpdesk/ticket_update.md): Changes a ticket's status, priority, category, subject, tags, fields, assignee, or the CRM records it is about. $0.01 a call.
- [ticket_merge](https://conecto.chat/tools/helpdesk/ticket_merge.md): Merges a duplicate ticket into another: its messages, notes, email threads, tags and fields move over. $0.01 a call.
- [ticket_connect_inbox](https://conecto.chat/tools/helpdesk/ticket_connect_inbox.md): Makes an inbox a support inbox: every new email to it opens a ticket, and replies stay in its thread. $0.001 a call.
- [ticket_save_template](https://conecto.chat/tools/helpdesk/ticket_save_template.md): Saves a canned reply under a name, with the status and tags it applies whenever it is sent. $0.001 a call.
- [ticket_list_templates](https://conecto.chat/tools/helpdesk/ticket_list_templates.md): Every saved reply with its text, status and tags. Free up to 1,000,000 reads a month.
- [ticket_delete_template](https://conecto.chat/tools/helpdesk/ticket_delete_template.md): Deletes a saved reply by name. $0.001 a call.
- [ticket_get_settings](https://conecto.chat/tools/helpdesk/ticket_get_settings.md): The help desk's SLA targets, auto-close, satisfaction survey setting and support inboxes. Free up to 1,000,000 reads a month.
- [ticket_update_settings](https://conecto.chat/tools/helpdesk/ticket_update_settings.md): Sets the SLA targets per priority, auto-close and the satisfaction survey. $0.001 a call.