Get team performance report

This API retrieves performance metrics for all teams (groups), including average response times, resolution times, and ticket counts with comparisons to the previous period.

GET /reports/groups

Get team performance report

cURL

curl --request GET \
  --url https://{your-subdomain}.neetodesk.com/api/external/v2/reports/groups \
  --header 'X-Api-Key: <x-api-key>'

200

{
  "teams": [
    {
      "id": "aaaabbbb-cccc-dddd-eeee-ffff00001111",
      "name": "Sales",
      "first_response_time": {
        "present": 123,
        "previous": 123,
        "change_percentage": 123
      },
      "resolution_time": {
        "present": 123,
        "previous": 123,
        "change_percentage": 123
      },
      "assigned": {
        "present": 123,
        "previous": 123,
        "change_percentage": 123
      },
      "closed": {
        "present": 123,
        "previous": 123,
        "change_percentage": 123
      }
    }
  ],
  "summary": {},
  "total_count": 3
}

Replace {your-subdomain} with your workspace’s subdomain.
Learn how to find your subdomain in Workspace subdomain.

Headers

X-Api-Key · string · default: your-api-key · required

Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.

Query Parameters

page_number · integer

Retrieve paginated results by specifying the desired page number. If this parameter is absent, all results will be returned.

range_type · enum<string> · default: last_30_days

Time range for the report. Use custom with start_date and end_date for custom date ranges.

Available options: 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, custom

start_date · string<date>

Start date for custom date range (YYYY-MM-DD format). Required when range_type is custom.

Example:

"2025-10-01"

end_date · string<date>

End date for custom date range (YYYY-MM-DD format). Required when range_type is custom.

Example:

"2025-10-31"

Response

200 - application/json

OK - Request succeeded

teams · object[]

Hide child attributes

teams. id · string

Example:

"aaaabbbb-cccc-dddd-eeee-ffff00001111"

teams. name · string

Example:

"Sales"

teams. first_response_time · object

Hide child attributes

teams.first_response_time. present · number

teams.first_response_time. previous · number

teams.first_response_time. change_percentage · number

teams. resolution_time · object

Hide child attributes

teams.resolution_time. present · number

teams.resolution_time. previous · number

teams.resolution_time. change_percentage · number

teams. assigned · object

Hide child attributes

teams.assigned. present · integer

teams.assigned. previous · integer

teams.assigned. change_percentage · number

teams. closed · object

Hide child attributes

teams.closed. present · integer

teams.closed. previous · integer

teams.closed. change_percentage · number

summary · object

Aggregated summary metrics for all teams, containing first_response_time, resolution_time, assigned, and closed objects, each with present, previous, and change_percentage values.

total_count · integer

Example:

3