> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.neetodesk.com/llms.txt > Use this file to discover all available pages before exploring further. # Reports > Show ticket volume, ticket time series, agent and group performance, and survey results. A report aggregates ticket activity over a date range. For fields and response details, see the [API reference](/api/reports/get-ticket-volume). ## 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: ```bash theme={"system"} 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`. ## 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. ```bash theme={"system"} neetodesk reports tickets --range-type last_30_days ``` | Flag | Type | Required | Default | 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) | ```json Sample output (--json) theme={"system"} { "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. ```bash theme={"system"} neetodesk reports ticket-time-series --range-type last_7_days ``` | Flag | Type | Required | Default | 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) | ```json Sample output (--json) theme={"system"} { "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. ```bash theme={"system"} neetodesk reports agents --range-type last_30_days ``` | Flag | Type | Required | 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 type (e.g. last\_7\_days, last\_30\_days, custom) | | `--start-date` | `string` | | | Start date for custom range (YYYY-MM-DD) | ```json Sample output (--json) theme={"system"} { "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. ```bash theme={"system"} neetodesk reports groups --range-type last_30_days ``` | Flag | Type | Required | 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 type (e.g. last\_7\_days, last\_30\_days, custom) | | `--start-date` | `string` | | | Start date for custom range (YYYY-MM-DD) | ```json Sample output (--json) theme={"system"} { "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. ```bash theme={"system"} neetodesk reports surveys --range-type last_30_days ``` | Flag | Type | Required | Default | 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) | ```json Sample output (--json) theme={"system"} { "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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.