Skip to main content
GET
/
dashboards
/
widgets
/
{id}
/
data
Get widget chart data
curl --request GET \
  --url https://api.cekura.ai/dashboards/widgets/{id}/data/ \
  --header 'X-CEKURA-API-KEY: <api-key>'
{
  "widget_id": 123,
  "field_name": "<string>",
  "chart_type": "<string>",
  "data": [
    {}
  ],
  "aggregation_function": "<string>",
  "time_period": "<string>",
  "group_by": null,
  "metadata": {
    "display_name": "<string>",
    "filter_value": "<unknown>"
  },
  "can_group_by": false
}

Authorizations

​
X-CEKURA-API-KEY
string
header
required

API Key Authentication. It should be included in the header of each request.

Path Parameters

​
id
string
required

Query Parameters

​
filters
object

filter JSON object to override widget filters for this request. Must include a timestamp constraint. Example: {"operator": "and", "conditions": [{"field": "timestamp", "op": "gte", "value": "now-7d"}]}

Response

200 - application/json
​
widget_id
integer
required
​
field_name
string
required
​
chart_type
string
required
​
data
object[]
required

Chart data. Format depends on chart_type:

Line chart: [{id, timestamp, value}, ...]

Bar chart: [{time_interval, value, sample_count}, ...]

Pie chart: [{label, value, percentage}, ...]

See the Dashboards guide for full examples.

Examples:
[
  {
    "id": 1,
    "timestamp": "2025-11-03T10:30:00Z",
    "value": 45
  },
  {
    "id": 2,
    "timestamp": "2025-11-03T11:15:00Z",
    "value": 62
  }
]
[
  {
    "time_interval": "2025-11-03T00:00:00Z",
    "value": 4.5,
    "sample_count": 10
  },
  {
    "time_interval": "2025-11-04T00:00:00Z",
    "value": 3.2,
    "sample_count": 8
  }
]
[
  {
    "label": "customer_ended_call",
    "value": 320,
    "percentage": 45.7
  },
  {
    "label": "agent_ended_call",
    "value": 210,
    "percentage": 30
  }
]
​
aggregation_function
string | null
required
​
time_period
string | null
required
​
group_by
unknown
required
​
metadata
object
required

Additional metadata about the plotted data. See the Dashboards guide for details.

​
can_group_by
boolean
default:false