Admin Queue Logs

Get paginated queue event logs with optional filters

POST /v2/admin/reporting/queues/logs

Admin Queue Logs

cURL

curl --request POST \
  --url https://api.voxo.co/v2/admin/reporting/queues/logs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "queueId": [
    1
  ],
  "startDate": "<string>",
  "endDate": "<string>"
}
'

200

{
  "queueIds": [
    123
  ],
  "records": [
    {
      "callId": "<string>",
      "event": "<string>",
      "queueId": 123,
      "timestamp": "<string>",
      "queueName": "<string>",
      "cidNum": "<string>",
      "cidName": "<string>",
      "peerName": "<string>",
      "waitTime": 123,
      "talkTime": 123
    }
  ],
  "total": 123,
  "page": 123,
  "maxPage": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

queueId · number[] · required

Queue IDs to include in the report

Required range: x > 0

startDate · string · required

Start date for the report period

endDate · string · required

End date for the report period

events · enum<string>[]

Filter by queue event types

Available options: AGENT_COMPLETE

users · string[] enum<string>

Filter by user peer names, or 'ALL' for all users

tag · string[]

Filter by call tags

Minimum array length: 1

callId · string

Filter by specific call ID

recordsPerPage · number

Number of records per page

page · number

Page number

reportType · Option 1 · enum<string> Option 2 · enum<string> Option 3 · enum<string>

Report type (Scheduled, Export, or Live)

Available options: Scheduled

Response

200

application/json

Queue logs or export acknowledgement

Option 1

Option 2

Paginated queue logs

queueIds · number[] · required

Queue IDs included

records · object[] · required

Queue log events

Show child attributes

total · number · required

Total matching records

page · number · required

Current page number

maxPage · number · required

Maximum page number