Reports

A report aggregates ticket activity over a date range. For fields and response details, see the API reference.

Choose 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

The named windows are last_7_days, last_30_days, last_24_hours, this_week, last_week, this_month, last_month, this_quarter, last_quarter, this_year, last_year, all_time, and custom. Without --range-type a report covers the last 30 days. The previous period has the same length as the range, so this_month is compared with all of last month. With a signed-in session, a report covers only the tickets you are allowed to see. Every report also returns start_date, end_date, previous_start_date, and previous_end_date. 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.

Show ticket volume

This command reports how many tickets entered each status over the range. Use this when you want 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: last_7_days, last_30_days, last_24_hours, this_week, last_week, this_month, last_month, this_quarter, last_quarter, this_year, last_year, all_time, or custom
`--start-date`	`string`	Start date for custom range (YYYY-MM-DD)

Sample output (--json)

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

Show the ticket time series

This command reports tickets opened and tickets closed on each day of the range, as two series aligned to the same list of dates. Use this when you want 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: last_7_days, last_30_days, last_24_hours, this_week, last_week, this_month, last_month, this_quarter, last_quarter, this_year, last_year, all_time, or custom
`--start-date`	`string`	Start date for custom range (YYYY-MM-DD)

Sample output (--json)

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

Show agent performance

This command 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. Use this when you review how each agent is doing. 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 (max 100)
`--range-type`	`string`		Date range: last_7_days, last_30_days, last_24_hours, this_week, last_week, this_month, last_month, this_quarter, last_quarter, this_year, last_year, all_time, or custom
`--start-date`	`string`		Start date for custom range (YYYY-MM-DD)

Sample output (--json)

{
  "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 }
    }
  ]
}

Show group performance

This command reports the same metrics as reports agents, aggregated per group instead of per agent, with each group’s id and name. Use this when you compare teams.

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 (max 100)
`--range-type`	`string`		Date range: last_7_days, last_30_days, last_24_hours, this_week, last_week, this_month, last_month, this_quarter, last_quarter, this_year, last_year, all_time, or custom
`--start-date`	`string`		Start date for custom range (YYYY-MM-DD)

Sample output (--json)

{
  "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 }
    }
  ]
}

Show survey results

This command reports how customers answered each satisfaction survey over the range, as a count per answer choice. Use this when you want to track customer satisfaction.

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: last_7_days, last_30_days, last_24_hours, this_week, last_week, this_month, last_month, this_quarter, last_quarter, this_year, last_year, all_time, or custom
`--start-date`	`string`	Start date for custom range (YYYY-MM-DD)

Sample output (--json)

{
  "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

Choose the date range

Show ticket volume

Show the ticket time series

Show agent performance

Show group performance

Show survey results

​Choose the date range

​Show ticket volume

​Show the ticket time series

​Show agent performance

​Show group performance

​Show survey results

Choose the date range

Show ticket volume

Show the ticket time series

Show agent performance

Show group performance

Show survey results