Get Widget Data - Cekura

Get widget chart data

curl --request GET \
  --url https://api.cekura.ai/dashboards/widgets/{id}/data/ \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cekura.ai/dashboards/widgets/{id}/data/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cekura.ai/dashboards/widgets/{id}/data/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cekura.ai/dashboards/widgets/{id}/data/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cekura.ai/dashboards/widgets/{id}/data/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "widget_id": 123,
  "field_name": "<string>",
  "chart_type": "<string>",
  "data": [
    {
      "id": 1,
      "timestamp": "2025-11-03T10:30:00Z",
      "value": 45
    },
    {
      "id": 2,
      "timestamp": "2025-11-03T11:15:00Z",
      "value": 62
    }
  ],
  "aggregation_function": "<string>",
  "time_period": "<string>",
  "group_by": null,
  "metadata": {
    "display_name": "<string>",
    "data_type": "numeric",
    "filter_value": "<unknown>"
  },
  "can_group_by": false
}

GET

/

dashboards

/

widgets

/

{id}

/

data

/

Get widget chart data

curl --request GET \
  --url https://api.cekura.ai/dashboards/widgets/{id}/data/ \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cekura.ai/dashboards/widgets/{id}/data/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cekura.ai/dashboards/widgets/{id}/data/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cekura.ai/dashboards/widgets/{id}/data/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cekura.ai/dashboards/widgets/{id}/data/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "widget_id": 123,
  "field_name": "<string>",
  "chart_type": "<string>",
  "data": [
    {
      "id": 1,
      "timestamp": "2025-11-03T10:30:00Z",
      "value": 45
    },
    {
      "id": 2,
      "timestamp": "2025-11-03T11:15:00Z",
      "value": 62
    }
  ],
  "aggregation_function": "<string>",
  "time_period": "<string>",
  "group_by": null,
  "metadata": {
    "display_name": "<string>",
    "data_type": "numeric",
    "filter_value": "<unknown>"
  },
  "can_group_by": false
}

Authorizations

Authorization

string

header

required

OAuth access token issued by Cekura for connected apps.

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

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.

Show child attributes

can_group_by

boolean

default:false

⌘I