categories and series, donut charts
a metric and slices, bubble charts points.
This is the chart-focused sibling of
get_report_data and
get_report_pivot_data: use
it after get_report when you need the
values the chart actually displays, rather than reconstructing them from raw
rows or pivot cells.
You can read a report granted to you directly, or one rendered as a chart tile
on a dashboard shared with you.
Values: an amount is rounded to 2 decimals, in calculation_currency. A
percentage field is the stored ratio, 0.8 for 80%; in a 100% stacked chart with
a breakout, values are instead percentages of each category’s total (0 to 100)
and tooltip_values hold the amounts. A null category reads ”-”. data_source
says whether the chart reads the report’s raw rows or its pivot table;
autosummed is true when rows sharing a category were added together. A date
category is labelled by the period it covers on the company fiscal calendar, in
the user’s language (Dec 2026, Q1 2026, H1 2026, 2026), never by a day.
The call is refused when:
- the report has no chart configured.
- the chart has too many categories: 200 on the x axis, or 50 on each axis when a breakout splits it; 100 for a donut; 200 for a bubble chart.
- the report is too large to compute.
- the chart reads raw rows spanning several pages. Add filters or a pivot table in the web app.
computed_at says when it was made. A deal or a statement changed since then
shows up only once the report is recomputed: call
refresh_report when computed_at is
older than the data you need.
Parameters
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
Body
Body
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.When the data served here was computed for you (UTC), the date the report
page in Qobra shows.
null when no stored computation was up to date and
this call computed the data on the spot, so it is current. A stored
computation reflects the records as they stood then: a deal or a statement
changed since shows up only once the report is recomputed. Call
refresh_report, then read again
until this date is later than the requested_at it returned.Donut charts
Body
Body
When the data served here was computed for you (UTC), the date the report
page in Qobra shows.
null when no stored computation was up to date and
this call computed the data on the spot, so it is current. A stored
computation reflects the records as they stood then: a deal or a statement
changed since shows up only once the report is recomputed. Call
refresh_report, then read again
until this date is later than the requested_at it returned.Bubble charts
Body
Body
One entry per plotted bubble.
value sizes the bubble and is null
when the chart doesn’t use a size metric.When the data served here was computed for you (UTC), the date the report
page in Qobra shows.
null when no stored computation was up to date and
this call computed the data on the spot, so it is current. A stored
computation reflects the records as they stood then: a deal or a statement
changed since shows up only once the report is recomputed. Call
refresh_report, then read again
until this date is later than the requested_at it returned.