CEcekura
dashboards

Get widget chart data

Changed on

Fetch the computed chart data for a saved widget.

Timestamp filter required: a gt or gte filter on timestamp must be present — either set on the dashboard, the widget, or passed here as filters. Maximum range: 30 days. Without it the request returns a 400 error.

Override filters: pass filters as a filter JSON object to temporarily replace the widget's own filters for this request. Example: {"operator": "and", "conditions": [{"field": "timestamp", "op": "gte", "value": "now-7d"}, {"field": "timestamp", "op": "lte", "value": "now"}]}

Response shape by chart type:

  • line — {data: [{id, timestamp, value}], metadata: {display_name, data_type, filter_value}}
  • bar — {data: [{time_interval, value, sample_count}], metadata: ...}
  • pie — {data: [{label, value, percentage}], metadata: ...}
  • stat — {data: {total_calls, success_rate, avg_duration, p95_latency}, metadata: ...}
get/dashboards/widgets/{id}/data/

Request

  • Base URL
    https://api.cekura.ai
  • URL
    https://api.cekura.ai/dashboards/widgets/{id}/data/
  • Auth
    • API key in header X-CEKURA-API-KEY
    • or HTTP bearer
    • or HTTP bearer
    • or API key in header X-VOCERA-SHAREABLE-LINK-TOKEN
    • or HTTP bearer

Path parameters

idstring required

Query parameters

filtersobject

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"}]}

timezonestring

IANA timezone name, e.g. America/Chicago. Day, week and month buckets and today filters use this timezone. Defaults to UTC when omitted or not recognized.

Response

widget_idinteger required
field_namestring required
chart_typestring required
dataobject[] required

Chart data. Format depends on chart_type:

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

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

Enum daily share: [{time_interval, group, value, selected_calls, total_calls, evaluated_calls}, ...], where value is the selected enum value's percentage of total filtered calls.

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

See the Dashboards guide for full examples.

aggregation_functionstring nullable required
time_periodstring nullable required
group_byunknown required
can_group_byboolean

Example response

{
  "data": [
    {
      "id": 1,
      "timestamp": "2025-11-03T10:30:00Z",
      "value": 45
    },
    {
      "id": 2,
      "timestamp": "2025-11-03T11:15:00Z",
      "value": 62
    }
  ]
}

Changes