Read charts

GET

/domains/{domain}/charts/{dashboard_id}

Last modified:2026-10-05 17:54:51

OperationId:ReadCharts

Returns the charts on a dashboard with their properties and data sources, each with a data token for loading its data.

Requires a token that can read charts in the domain in the path. The dashboard must be one you can see: one you own, one shared with the domain or with you, or a stock dashboard offered to your scope. Office Manager, Site Manager, Call Center Supervisor, and Reseller can also see dashboards owned by users with a lower scope in their own domain or territory, and Super User can see every dashboard. A dashboard you cannot see returns 403. A dashboard that is not in this domain, and is not a stock dashboard, returns 404.

Each chart carries a data_token: an access token issued to you, in the dashboard's domain (your own domain for a stock dashboard), with Call Center Data scope. Use it to read the call center data the charts show. Every chart in one response carries the same token. It lasts expires_in seconds, a day by default, and cannot be refreshed: read the charts again for a new one.

Send only the filters listed here. A query-builder key such as OR or joins, or a filter name that is not a plain field name, returns 400.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

The charts on the dashboard. An empty array, with no token, when it has none.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/charts/42?id=63&type=ResponsiveLine&placeholder_id=undefined&limit=undefined&start=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - One chart

[
    {
        "id": 63,
        "name": "Abandoned Calls",
        "dashboard_id": 42,
        "type": "ResponsiveLine",
        "description": "Calls abandoned per hour, today.",
        "properties": "{\"color\":\"blue\"}",
        "data_sources": "[{\"object\":\"callqueuereport\",\"queue\":\"Support Line\"}]",
        "status": 1,
        "created": "2026-08-14T09:05:00+00:00",
        "last-modified-datetime": null,
        "data_token": {
            "access_token": "{{data_access_token}}",
            "expires_in": 86400,
            "user-scope": "Call Center Data",
            "mask_chain": null,
            "token_type": "Bearer"
        }
    }
]

Modified at 2026-10-05 17:54:51

List charts

Create chart