---
title: "GET /dashboards/widgets/"
method: GET
path: "/dashboards/widgets/"
tags: ["dashboards"]
---

# GET /dashboards/widgets/

`GET /dashboards/widgets/`

List dashboard widgets

## Query parameters

- `page` integer
- `page_size` integer
- `dashboard_id` integer

## Response `200`

- PaginatedWidgetList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Widget[], required
    - `id` integer
    - `dashboard` integer, nullable — Dashboard this widget belongs to
    - `name` string, nullable — Optional name/title for the widget
    - `filters` object, nullable — Filter conditions to scope the data. See the [Dashboards guide](https://docs.cekura.ai/documentation/guides/dashboards#filters) for supported fields, operators, and syntax.
      - `field` string — Field name to filter on
      - `op` 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'regex' — Comparison operator
      - `value` unknown
      - `operator` 'and' | 'or' | 'same_row' — Logical operator to combine conditions
      - `conditions` unknown[] — List of filter conditions or nested groups
        - unknown
    - `effective_filters` object — Merged filters from dashboard and widget (read-only). Can be used with the call logs API filters_v2 parameter.
      - `field` string — Field name to filter on
      - `op` 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'startswith' | 'endswith' | 'in' | 'isnull' | 'regex' — Comparison operator
      - `value` unknown
      - `operator` 'and' | 'or' | 'same_row' — Logical operator to combine conditions
      - `conditions` unknown[] — List of filter conditions or nested groups
        - unknown
    - `chart_type` 'line' | 'bar' | 'pie' | 'stat', required — Type of chart to display * `line` - Line * `bar` - Bar * `pie` - Pie * `stat` - Stat
    - `data_type` 'numeric' | 'boolean' | 'string' | 'datetime' | 'dynamic' | '' | 'null', nullable — Data type of the field being plotted (optional, can be inferred) * `numeric` - Numeric * `boolean` - Boolean * `string` - String * `datetime` - DateTime * `dynamic` - Dynamic
    - `field` string — Field name to plot. See the [Dashboards guide](https://docs.cekura.ai/documentation/guides/dashboards#supported-fields) for available fields, valid chart types, and aggregation combinations.
    - `metric` integer, nullable — Metric to use when field is 'metric_evaluations.value'
    - `metric_name` string — Name of the metric (if metric is set)
    - `time_period` 'hour' | 'day' | 'week' | 'month' | '' | 'null', nullable — Time period for aggregation (for bar charts) * `hour` - Hour * `day` - Day * `week` - Week * `month` - Month
    - `aggregation_function` 'count' | 'sum' | 'avg' | 'min' | 'max' | 'p50' | 'p95' | 'p99' | '' | 'null', nullable — Aggregation function to apply (for bar charts) * `count` - Count * `sum` - Sum * `avg` - Average * `min` - Minimum * `max` - Maximum * `p50` - 50th Percentile (Median) * `p95` - 95th Percentile * `p99` - 99th Percentile
    - `group_by` unknown
    - `metadata` unknown
    - `created_at` string, date-time, nullable — When the widget was created
    - `updated_at` string, date-time, nullable — When the widget was last updated

---

[API](https://skmtc.net/cekura/apis/cekura-api.md) · [All operations](https://skmtc.net/cekura/apis/cekura-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cekura/cekura-api/revisions/d08e85615b58/schema)