> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qobra.co/llms.txt
> Use this file to discover all available pages before exploring further.

# get_report_chart_data

Return every value produced by a report's configured chart.

The chart-focused sibling of `get_report_data` and `get_report_pivot_data`:
use this after `get_report` when you need the values actually displayed by the
chart — categories, series, slices or points — rather than reconstructing them
from raw rows or pivot cells. Bar, line and combo charts return categories and
series; donut charts return a metric and slices; bubble charts return points.
Pivot-backed charts use their relevant aggregates and subtotals, while
raw-backed charts apply the chart's summing and percentage-normalization rules.

The complete chart payload is returned in one call, with no pagination. A
missing chart configuration, excessive cardinality, or a report too large to
calculate raises a clear error. You only see reports you have access to.

## Parameters

<Accordion title="Body" defaultOpen>
  <ParamField body="report" type="string" required>
    The report to read. Accepts the report's ObjectId (the id returned by
    list\_reports) or a case- and accent-insensitive substring of its name. A
    name matching no — or more than one — report raises a clear error; pass the
    full id to disambiguate.
  </ParamField>
</Accordion>

## Response

The response shape depends on the chart's type. `chart_type` is the
discriminator; `data_source` reflects the underlying report configuration
(`raw`, `chart` or `pivot_table`); `autosummed` is `true` when the
chart summed values automatically to produce these totals.

### Bar, line and combo charts

<Accordion title="Body" defaultOpen>
  <ResponseField name="report_id" type="string" />

  <ResponseField name="resource_url" type="string">
    Deep link to open this report in the Qobra web app.
  </ResponseField>

  <ResponseField name="chart_type" type="string">
    One of: `bar`, `line`, `combo`.
  </ResponseField>

  <ResponseField name="data_source" type="string">
    One of: `raw`, `chart`, `pivot_table`.
  </ResponseField>

  <ResponseField name="categories" type="object[]">
    The x-axis values, in the order the chart lays them out.

    <Expandable title="object properties">
      <ResponseField name="value" type="any" />
    </Expandable>
  </ResponseField>

  <ResponseField name="series" type="object[]">
    One entry per plotted series. `values` is aligned to `categories` (same
    length, same order); `tooltip_values` mirrors it when the chart shows a
    secondary tooltip metric.

    <Expandable title="object properties">
      <ResponseField name="field_id" type="string" />

      <ResponseField name="field_name" type="string" />

      <ResponseField name="chart_series_type" type="string">
        One of: `bar`, `line`.
      </ResponseField>

      <ResponseField name="breakout" type="object">
        The breakout category this series is split by, or `null` when the
        series isn't broken out.

        <Expandable title="object properties">
          <ResponseField name="value" type="any" />
        </Expandable>
      </ResponseField>

      <ResponseField name="values" type="number[]" />

      <ResponseField name="tooltip_values" type="number[]" />
    </Expandable>
  </ResponseField>

  <ResponseField name="autosummed" type="boolean" />
</Accordion>

### Donut charts

<Accordion title="Body" defaultOpen>
  <ResponseField name="report_id" type="string" />

  <ResponseField name="resource_url" type="string">
    Deep link to open this report in the Qobra web app.
  </ResponseField>

  <ResponseField name="chart_type" type="string">
    Always `donut`.
  </ResponseField>

  <ResponseField name="data_source" type="string">
    One of: `raw`, `chart`, `pivot_table`.
  </ResponseField>

  <ResponseField name="metric" type="object">
    The field the donut is measuring.

    <Expandable title="object properties">
      <ResponseField name="field_id" type="string" />

      <ResponseField name="field_name" type="string" />
    </Expandable>
  </ResponseField>

  <ResponseField name="slices" type="object[]">
    One entry per donut slice.

    <Expandable title="object properties">
      <ResponseField name="category" type="object">
        <Expandable title="object properties">
          <ResponseField name="value" type="any" />
        </Expandable>
      </ResponseField>

      <ResponseField name="value" type="number" />
    </Expandable>
  </ResponseField>

  <ResponseField name="autosummed" type="boolean" />
</Accordion>

### Bubble charts

<Accordion title="Body" defaultOpen>
  <ResponseField name="report_id" type="string" />

  <ResponseField name="resource_url" type="string">
    Deep link to open this report in the Qobra web app.
  </ResponseField>

  <ResponseField name="chart_type" type="string">
    Always `scatter`.
  </ResponseField>

  <ResponseField name="data_source" type="string">
    One of: `raw`, `chart`, `pivot_table`.
  </ResponseField>

  <ResponseField name="points" type="object[]">
    One entry per plotted bubble. `value` sizes the bubble and is `null`
    when the chart doesn't use a size metric.

    <Expandable title="object properties">
      <ResponseField name="category" type="object">
        <Expandable title="object properties">
          <ResponseField name="value" type="any" />
        </Expandable>
      </ResponseField>

      <ResponseField name="x" type="number" />

      <ResponseField name="y" type="number" />

      <ResponseField name="value" type="number" />
    </Expandable>
  </ResponseField>

  <ResponseField name="autosummed" type="boolean" />
</Accordion>
