Reports commands

The reports command lets you view NeetoDesk reports from the terminal.

Agent performance report

This command shows agent performance metrics for a date range. Use this when you want a snapshot of agent activity without opening the Reports section.

neetodesk reports agents --range-type last_7_days
neetodesk reports agents --range-type custom --start-date 2026-06-01 --end-date 2026-06-24

Optional flags:

• --range-type - Date range type (e.g. last_7_days, last_30_days, custom)

• --start-date - Start date for custom range (YYYY-MM-DD)

• --end-date - End date for custom range (YYYY-MM-DD)

• --page - Page number

• --page-size - Items per page

• --subdomain <name> - Target a specific logged-in workspace

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON (token-optimized) output

Sample output:

NAME   ID                                  
────   ────────────────────────────────────
Lucy   09395391-b43f-4ced-8e3d-7d62f13c859a

Group performance report

This command shows group performance metrics for a date range. Use this when you want to compare group-level ticket handling.

neetodesk reports groups --range-type last_7_days

Optional flags:

• --range-type - Date range type (e.g. last_7_days, last_30_days, custom)

• --start-date - Start date for custom range (YYYY-MM-DD)

• --end-date - End date for custom range (YYYY-MM-DD)

• --page - Page number

• --page-size - Items per page

• --subdomain <name> - Target a specific logged-in workspace

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON (token-optimized) output

Sample output:

NAME           ID                                  
────────────   ────────────────────────────────────
Sample group   9e685fa2-4313-4164-9c09-c79d968f043d

Customer satisfaction surveys report

This command shows customer satisfaction survey results for a date range. Use this when you want CSAT summaries from the terminal.

neetodesk reports surveys --range-type last_30_days

Optional flags:

• --range-type - Date range type (e.g. last_7_days, last_30_days, custom)

• --start-date - Start date for custom range (YYYY-MM-DD)

• --end-date - End date for custom range (YYYY-MM-DD)

• --subdomain <name> - Target a specific logged-in workspace

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON (token-optimized) output

Sample output:

NAME              ID                               QUESTION                                                               
───────────────   ──────────────────────────────   ───────────────────────────────────────────────────────────────────────
Satisfaction...   47322c7a-0a12-4ca7-930c-ee2...   How would you rate your overall satisfaction for the resolution prov..

Ticket creation and closure time series report

This command shows ticket creation and closure counts over time for a date range. Use this when you want trend data for ticket volume.

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

Optional flags:

• --range-type - Date range type (e.g. last_7_days, last_30_days, custom)

• --start-date - Start date for custom range (YYYY-MM-DD)

• --end-date - End date for custom range (YYYY-MM-DD)

• --subdomain <name> - Target a specific logged-in workspace

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON (token-optimized) output

Sample output:

DATES  (7 items)
  DATA   (2 items)

Ticket status change report

This command shows ticket status change counts for a date range. Use this when you want a breakdown of tickets by status.

neetodesk reports tickets --range-type last_30_days

Optional flags:

• --range-type - Date range type (e.g. last_7_days, last_30_days, custom)

• --start-date - Start date for custom range (YYYY-MM-DD)

• --end-date - End date for custom range (YYYY-MM-DD)

• --subdomain <name> - Target a specific logged-in workspace

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON (token-optimized) output

Sample output:

NAME  
──────
closed
new   
open