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.

reports tickets

Reports how many tickets entered each status over the range. Use it for a volume snapshot.

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)

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.

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)

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.

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": {
    "members": [
      {
        "id": "7b2c1d40-5e6f-4a81-9c23-0d4e5f6a7b8c",
        "name": "Oliver Smith",
        "first_response_time": {
          "present": 1820,
          "previous": 2140,
          "change_percentage": -14.95
        },
        "resolution_time": {
          "present": 16400,
          "previous": 15200,
          "change_percentage": 7.89
        },
        "assigned": { "present": 42, "previous": 38, "change_percentage": 10.53 },
        "closed": { "present": 39, "previous": 35, "change_percentage": 11.43 }
      }
    ],
    "total_count": 1
  }
}

reports groups

The same metrics as reports agents, aggregated per group instead of per agent.

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)

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)

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