Skip to content

Retrieves all user reports.

Method get.reports_list
Description Retrieves all user reports.
Who has access Agents and clients
Required components Data API for configuration
Request weight 1 point

Request parameters

Name Type Required Description
access_token string yes Authentication session key
user_id number no Unique user identifier of the agent client on behalf of which the request is made (Is required for the agent) To obtain a list of client users, you must use the method ""get.customer_users""
limit number no Number of records returned. See section "Paging"
offset number no Shift - determines from which record number to return "limit" records. Default is "0". See section "Paging"
filter object no See section "Filtering Criteria"
fields array no See "View of Returned Data"
sort array no See section "Sorting data"

Response parameters

Name Type Valid values Filtering Sorting Default response Description
id number yes yes yes User report unique identifier
type enum summary_analytics ad_analytics chat_summary call_summary communications call_tracking_monitoring deals chats dashboard calls mgf_calls communications_operator_workplace person_summary leads yes yesyes User report type
name string yes User report name
description string yes User report description
group_id number yes Report group ID
sort number Sorting reports in the menu
is_mobile boolean yes yes The report is used in the mobile version of the account
is_editable boolean yes yes Is it editable
is_favorite boolean yes yes Is the report a favorite
date_time_added_to_favorite iso8601 YYYY-MM-DD hh:mm:ss yes yes Date and time the report was added to favorites

Example request

{
"jsonrpc":"2.0",
"id":"number",
"method":"get.reports_list",
"params":{
"access_token":"string",
"user_id":"number",
"offset":"number",
"limit":"number",
"filter":{
},
"sort":[
{
"field":"string",
"order":"string"
}
],
"fields":[
"string"
]
}

}

Example response

{
"jsonrpc": "2.0",
"id": "number",
"result": {
"metadata": {

},
"data": [
{
"id": "number",
"type": "enum",
"name": "string",
"description": "string",
"group_id": "number",
"sort": "number",
"is_mobile": "boolean",
"is_editable": "boolean",
"is_favorite": "boolean",
"date_time_added_to_favorite": "iso8601"
}
]
}
}

Example response

{
"result": {
"metadata": {
"total_items": 1
},
"data": [
{
"name": "Traffic analysis",
"type": "summary_analytics",
"id": 2,
"description": null,
"group_id": 6,
"sort": 200,
"is_mobile": false,
"is_editable": false,
"is_favorite": true,
"date_time_added_to_favorite": "2024-08-20 13:54:07"
}
]
},
"id": "1",
"jsonrpc": "2.0"
}

Possible errors

See the "Errors for get methods" section.