Zum Hauptinhalt springen
GET
/
report
/
{reportCode}
Get report data
curl --request GET \
  --url https://demo.enneo.ai/api/mind/report/{reportCode} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "dueInMoreThan24Hours": 10,
    "dueInNext24Hours": 5,
    "overdue24Hours": 3,
    "overdue24To48Hours": 2,
    "overdueMoreThan48Hours": 1,
    "totalTickets": 21
  },
  "description": "Tickets in status 'open', broken down by due date compared to the current time.",
  "summary": {
    "title": "Open tickets",
    "amount": 63,
    "description": ""
  },
  "total": 42,
  "filters": {
    "lastDays": 14,
    "agent": "own"
  }
}

Autorisierungen

​
Authorization
string
header
erforderlich

JWT-based authentication

Pfadparameter

​
reportCode
enum<string>
erforderlich

The type of report to retrieve

Verfügbare Optionen:
openTickets,
channelMix,
solvedTicketsByTeam,
solvedTicketsByResolution,
incomingVolume,
customerSurveys,
telephonyLines,
telephonyAgents,
telephonyAiAgents,
telephonyPerformance,
telephonyCallInsights,
telephonyLineTopPerformers

Abfrageparameter

​
status
string

Filter by status. Supported values depend on the report type:

  • channelMix: open, closed, pending (ticket status)
  • telephonyAgents: all, assignedToPhone, online, onlineActive (user status categories)
​
channel
enum<string>

Filter by channel (only for channelMix report)

Verfügbare Optionen:
email,
portal,
phone,
system,
chat,
letter
​
lastDays
enum<string>

Number of days to look back (for solvedTicketsByTeam, solvedTicketsByResolution, incomingVolume, channelMix, telephonyPerformance, telephonyCallInsights, telephonyLineTopPerformers, and other telephony reports)

Verfügbare Optionen:
0,
1,
3,
7,
14,
30,
90,
365
​
agent
enum<string>

Filter by agent type (only for solvedTicketsByResolution, solvedTicketsByTeam, customerSurveys report)

Verfügbare Optionen:
own,
team,
all
​
ticketScope
enum<string>

Restrict the report to tickets matching the agent's configured skill tags (only for openTickets, channelMix, solvedTicketsByTeam, customerSurveys reports).

  • all: no skill-based restriction
  • skills: restrict to tickets whose routing-relevant tags overlap the agent's actualSkills.tagIds When the agent has no skill tags configured, skills behaves like all.
Verfügbare Optionen:
all,
skills
​
teamIds
string

Filter by teams (only for telephonyAgents report). Can be 'all' or comma-separated team IDs.

​
lineIds
string

Filter by telephony lines (for telephonyAgents and telephonyAiAgents reports). Can be 'all' or comma-separated line IDs.

​
show
enum<string>

Filter by user type (only for telephonyAgents report). Defaults to 'users' if not provided.

Verfügbare Optionen:
users,
all,
enneo,
serviceWorkers,
codeExecutors,
enneoPartners
​
q
string

Search by agent name (case-insensitive substring, only for telephonyAgents report).

​
limit
integer

Maximum number of items to return (only for telephonyAgents report). Defaults to 1000.

Erforderlicher Bereich: x >= 1
​
offset
integer

Number of items to skip for pagination (only for telephonyAgents report). Defaults to 0.

Erforderlicher Bereich: x >= 0
​
lineId
string

Filter by specific telephony line ID (for telephonyPerformance, telephonyCallInsights, telephonyLineTopPerformers reports). Required for telephonyLineTopPerformers.

​
agentsType
enum<string>

Filter by agent type (only for telephonyLineTopPerformers report). Defaults to 'all' if not provided.

Verfügbare Optionen:
all,
ai,
human
​
granularity
enum<string>

Time bucket size for time-series reports. When omitted the response is byte-identical to the pre-granularity behaviour (including the legacy 0–23 hour-of-day profile for callsAnsweredByHour). Applicable reports — hour/day/week/month: incomingVolume, telephonyPerformance, telephonyCallInsights (aiHandledVsHuman + callsAnsweredByHour timeline), telephonyAgentPerformance, telephonyAiAgentPerformance, telephonyAiAgentCallInsights. Day/week/month only (DATE column, no time-of-day): solvedTicketsByTeam, solvedTicketsByResolution.

  • hour: one bucket per clock-hour, keys in "YYYY-MM-DD HH:00" format; only allowed with lastDays ≤ 31
  • day: one bucket per calendar day, keys in dd.mm format (legacy default)
  • week: one bucket per ISO week, keys in YYYY-WNN format
  • month: one bucket per calendar month, keys in YYYY-MM format
Verfügbare Optionen:
hour,
day,
week,
month

Antwort

Successful operation

​
data
object

For openTickets report

​
description
string

Description of what the report shows

Beispiel:

"Tickets in status 'open', broken down by due date compared to the current time."

​
summary
object

For channelMix report

​
total
integer

Total number of items after filters and search, before pagination (only present for reports that support pagination, e.g. telephonyAgents).

Beispiel:

42

​
filters
object

The filters that were applied to generate this report

Beispiel:
{ "lastDays": 14, "agent": "own" }