reports

Reports aggregate ticket activity over a date range. For fields and response details, see the API reference.

Sample output on this page is shown as the --json envelope, which is reproducible. Pretty tables depend on your terminal width. See Output formats.

Choosing the date range

Every report takes the same three range flags. Pass --range-type for a named window, such as last_7_days or last_30_days. Pass --range-type custom together with --start-date and --end-date for an exact one:

neetodesk reports tickets --range-type last_30_days
neetodesk reports tickets --range-type custom --start-date 2026-07-01 --end-date 2026-07-31

Dates are YYYY-MM-DD. Every figure that is compared against the previous period of the same length comes back as present, previous and change_percentage.

reports tickets

Reports how many tickets entered each status over the range. Use it for a volume snapshot. The pretty output is a table with one row per status.

neetodesk reports tickets --range-type last_30_days

Flag	Type	Description
`--end-date`	`string`	End date for custom range (YYYY-MM-DD)
`--range-type`	`string`	Date range type (e.g. last_7_days, last_30_days, custom)
`--start-date`	`string`	Start date for custom range (YYYY-MM-DD)

{
  "data": [
    {
      "name": "new",
      "value": { "present": 120, "previous": 98, "change_percentage": 22.45 }
    },
    {
      "name": "closed",
      "value": { "present": 87, "previous": 91, "change_percentage": -4.4 }
    }
  ]
}

reports ticket-time-series

Reports tickets opened and tickets closed on each day of the range, as two series aligned to the same list of dates. Use it to plot a trend rather than a single total. The pretty output is a table with one row per date.

neetodesk reports ticket-time-series --range-type last_7_days

Flag	Type	Description
`--end-date`	`string`	End date for custom range (YYYY-MM-DD)
`--range-type`	`string`	Date range type (e.g. last_7_days, last_30_days, custom)
`--start-date`	`string`	Start date for custom range (YYYY-MM-DD)

{
  "data": {
    "dates": ["2026-08-01", "2026-08-02", "2026-08-03"],
    "data": [
      { "name": "new", "values": [12, 9, 14] },
      { "name": "closed", "values": [8, 11, 10] }
    ]
  }
}

reports agents

Reports each agent’s average first-response time, average resolution time, and assigned and closed ticket counts, each compared against the previous period of the same length. Times are in seconds. The summary and total_count the API returns alongside the list are not part of the CLI output.

neetodesk reports agents --range-type last_30_days

Flag	Type	Default	Description
`--end-date`	`string`		End date for custom range (YYYY-MM-DD)
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page
`--range-type`	`string`		Date range type (e.g. last_7_days, last_30_days, custom)
`--start-date`	`string`		Start date for custom range (YYYY-MM-DD)

{
  "data": [
    {
      "id": "7b2c1d40-5e6f-4a81-9c23-0d4e5f6a7b8c",
      "name": "Oliver Smith",
      "first_response_time": {
        "present": 1820.0,
        "previous": 2140.0,
        "change_percentage": -14.95
      },
      "resolution_time": {
        "present": 16400.0,
        "previous": 15200.0,
        "change_percentage": 7.89
      },
      "assigned": { "present": 42, "previous": 38, "change_percentage": 10.53 },
      "closed": { "present": 39, "previous": 35, "change_percentage": 11.43 }
    }
  ]
}

reports groups

The same metrics as reports agents, aggregated per group instead of per agent, with each group’s id and name.

neetodesk reports groups --range-type last_30_days

Flag	Type	Default	Description
`--end-date`	`string`		End date for custom range (YYYY-MM-DD)
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page
`--range-type`	`string`		Date range type (e.g. last_7_days, last_30_days, custom)
`--start-date`	`string`		Start date for custom range (YYYY-MM-DD)

{
  "data": [
    {
      "id": "a29d5c31-8e42-4f16-b73a-1d9c4e6f8a02",
      "name": "Payments",
      "first_response_time": {
        "present": 1540.0,
        "previous": 1780.0,
        "change_percentage": -13.48
      },
      "resolution_time": {
        "present": 14200.0,
        "previous": 15600.0,
        "change_percentage": -8.97
      },
      "assigned": { "present": 65, "previous": 58, "change_percentage": 12.07 },
      "closed": { "present": 61, "previous": 54, "change_percentage": 12.96 }
    }
  ]
}

reports surveys

Reports how customers answered each satisfaction survey over the range, as a count per answer choice.

neetodesk reports surveys --range-type last_30_days

Flag	Type	Description
`--end-date`	`string`	End date for custom range (YYYY-MM-DD)
`--range-type`	`string`	Date range type (e.g. last_7_days, last_30_days, custom)
`--start-date`	`string`	Start date for custom range (YYYY-MM-DD)

{
  "data": [
    {
      "id": "b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e",
      "name": "Post-resolution survey",
      "question": "How satisfied are you with the support you received?",
      "choices": [
        { "name": "Satisfied", "count": 31, "slug": "satisfied" },
        { "name": "Unsatisfied", "count": 4, "slug": "unsatisfied" }
      ]
    }
  ]
}

reports agents and reports groups accept --page and --page-size. reports tickets, reports ticket-time-series and reports surveys return the whole range and do not paginate.

Getting Started

Commands

Choosing the date range

reports tickets

reports ticket-time-series

reports agents

reports groups

reports surveys

​Choosing the date range

​reports tickets

​reports ticket-time-series

​reports agents

​reports groups

​reports surveys

Choosing the date range

reports tickets

reports ticket-time-series

reports agents

reports groups

reports surveys