---
title: "Get Chart builder data"
method: GET
path: "/reports/chart-builder"
---

# Get Chart builder data

`GET /reports/chart-builder`

## Request

- Base URL: `https://api.web2wave.com/api`
- URL: `https://api.web2wave.com/api/reports/chart-builder`
- Auth: API key in header `api_key`

Returns the same chart data as the cabinet "Chart builder" (labels + datasets),
scoped to the project of the API key. Use `GET /reports/chart-builder/catalog`
to discover valid `metric`, `x_axis` and `series` ids.
`from`/`to` are interpreted in the project timezone; defaults to the last 30 days.

## Query parameters

- `metric` string, required
- `x_axis` string
- `series` string
- `sort` 'value' | 'label'
- `direction` 'asc' | 'desc'
- `y_operator` '>' | '>=' | '<' | '<=' | '='
- `y_value` number
- `from` string, date
- `to` string, date
- `quizzes` union
  - string[]
  - string: Comma-separated values
- `paywalls` union
  - string[]
  - string: Comma-separated values
- `utm_source` union
  - string[]
  - string: Comma-separated values
- `utm_medium` union
  - string[]
  - string: Comma-separated values
- `utm_campaign` union
  - string[]
  - string: Comma-separated values
- `utm_content` union
  - string[]
  - string: Comma-separated values
- `utm_term` union
  - string[]
  - string: Comma-separated values
- `payment_system` integer
- `user_country_code` string
- `user_platform` string
- `experiment_id` integer
- `experiment_variant` integer
- `user_property` string
- `user_property_value` string

## Headers

- `api_key` string, required

## Response `200`

Chart data

- object
  - `success` boolean
  - `from` string, date-time
  - `to` string, date-time
  - `builder` object
    - `title` string
    - `metric` string
    - `format` string
    - `labels` string[]
    - `datasets` object[]
      - `label` string
      - `data` number[]
      - `borderColor` string
      - `backgroundColor` string
    - `rows` object[]: Raw rows (`x_value`, `series_value`, `metric_value`).

## Other responses

- `422`: Validation error or unknown metric / dimension

## Changes

- **2026-11-03** `eb8b2d9124ac`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/web2wave/apis/web2wave-api/changes/reports/chart-builder/get.md)

---

[API](https://skmtc.dev/web2wave/apis/web2wave-api.md) - [All operations](https://skmtc.dev/web2wave/apis/web2wave-api/llms.txt) - [OpenAPI document](https://skmtc.dev/web2wave/apis/web2wave-api/revisions/eb8b2d9124ac?raw)