▣ IMAGE PROCESSING · SMART GENERATION

Stacked Bar Chart Generator

What it does

Stacked Bar Chart Generator turns structured series data into a stacked bar chart image or a downloadable chart link. Send a title, a data array, and optional theme or options; get back either a pre-signed URL in data from /link or binary image output from /download.

Each data point includes a name and a values array. Inside each value, you can provide a label, a numeric value, and an optional hex color. You can also set per-bar width and control chart presentation with options such as width, height, spacing, bar_width, canvas_color, background_padding, axis font settings, and title styling.

Use Stacked Bar Chart Generator when you need to compare parts of a whole across categories, such as revenue vs. cost by quarter, traffic sources by month, or budget allocation by team. The theme supports light and dark, making it easier to embed charts in dashboards, reports, or internal tools with different visual styles.

The /link endpoint is useful when you want a shareable image URL, while /download is for retrieving the generated chart directly as a binary file.

▣ ENDPOINT 01 / 02

POST

Generate stacked bar chart link

https://api.eu.apyverse.com/apyhub/generate-stacked-bar-chart/link

QUICKSTART

GUIDE

Quickstart

Generate a stacked bar chart image URL from the chart data in the request body.

curl -X POST "https://api.eu.apyverse.com/apyhub/generate-stacked-bar-chart/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quarterly Revenue and Cost",
    "data": [
      {
        "name": "Q1",
        "width": 56,
        "values": [
          { "color": "3B82F6", "label": "Revenue", "value": 100000 },
          { "color": "EF4444", "label": "Cost", "value": 62000 }
        ]
      },
      {
        "name": "Q2",
        "width": 56,
        "values": [
          { "color": "3B82F6", "label": "Revenue", "value": 118000 },
          { "color": "EF4444", "label": "Cost", "value": 69000 }
        ]
      }
    ]
  }'

What you'll get back

Returns a JSON object with a data string field containing a pre-signed URL to the generated chart image.

{
  "data": "https://example.com/generated/charts/chart.png"
}

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Generates a stacked bar chart and returns a link to the generated chart image. The request body contains the chart definition, including the required title and data fields, plus optional theme and styling options.

Request Body

Parameter	Type	Mandatory	Description
data	Object Array	Yes	Array of stacked bar groups. Each item must include `name` and `values`; `width` is optional. Each `values` item contains a `label` and `value`, and may include `color` as a 6-character hex string without the leading `#`.
data[].name	String	Yes	Group label, such as a quarter name.
data[].width	Integer	No	Bar width in pixels. Minimum: 1.
data[].values	Object Array	Yes	Array of stacked segments for the bar. Each item must include `label` and `value`; `color` is optional.
data[].values[].color	String	No	6-character hex color without the leading `#`. Pattern: `^[A-Fa-f0-9]{6}$`.
data[].values[].label	String	Yes	Segment label.
data[].values[].value	Number	Yes	Segment value.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Yes	Chart title. Minimum length: 1.
options	Object	No	Chart display options. Includes `width`, `height`, `spacing`, `bar_width`, `canvas_color`, `background_padding`, and nested style objects for axes and title. See schema for nested fields.
options.width	Integer	No	Chart width in pixels. Minimum: 1.
options.height	Integer	No	Chart height in pixels. Minimum: 1.
options.x_axis	Object	No	X-axis styling options. `font_size` is in pixels; `font_color` is a 6-character hex string without the leading `#`.
options.x_axis.font_size	Number	No	Font size in pixels. Minimum: 1.
options.x_axis.font_color	String	No	6-character hex color without the leading `#`. Pattern: `^[A-Fa-f0-9]{6}$`.
options.y_axis	Object	No	Y-axis styling options. `font_size` is in pixels; `font_color` is a 6-character hex string without the leading `#`.
options.y_axis.font_size	Number	No	Font size in pixels. Minimum: 1.
options.y_axis.font_color	String	No	6-character hex color without the leading `#`. Pattern: `^[A-Fa-f0-9]{6}$`.
options.spacing	Integer	No	Spacing between bars. Minimum: 0.
options.bar_width	Integer	No	Bar width in pixels. Minimum: 1.
options.title_style	Object	No	Title styling options. `padding` is in pixels; `font_size` is in pixels; `font_color` is a 6-character hex string without the leading `#`.
options.title_style.padding	Integer	No	Padding in pixels. Minimum: 0.
options.title_style.font_size	Number	No	Font size in pixels. Minimum: 1.
options.title_style.font_color	String	No	6-character hex color without the leading `#`. Pattern: `^[A-Fa-f0-9]{6}$`.
options.canvas_color	String	No	6-character hex color without the leading `#`. Pattern: `^[A-Fa-f0-9]{6}$`.
options.background_padding	Integer	No	Padding around the chart background in pixels. Minimum: 0.

Response

Returns a JSON object with a data string field. The data value is a URI that points to the generated chart image.

Parameter	Type	Mandatory	Description
data	String	Yes	Pre-signed URL for the generated chart image.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 02 / 02

POST

Generate stacked bar chart image

https://api.eu.apyverse.com/apyhub/generate-stacked-bar-chart/download

QUICKSTART

GUIDE

Quickstart

Generate a stacked bar chart and download it as a binary file.

curl -X POST "https://api.eu.apyverse.com/apyhub/generate-stacked-bar-chart/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quarterly Revenue and Cost",
    "data": [
      {
        "name": "Q1",
        "width": 56,
        "values": [
          { "color": "3B82F6", "label": "Revenue", "value": 100000 },
          { "color": "EF4444", "label": "Cost", "value": 62000 }
        ]
      },
      {
        "name": "Q2",
        "width": 56,
        "values": [
          { "color": "3B82F6", "label": "Revenue", "value": 118000 },
          { "color": "EF4444", "label": "Cost", "value": 69000 }
        ]
      }
    ]
  }'

What you'll get back

Returns a binary file (string with format: "binary"), which is the generated stacked bar chart download.

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Generates and downloads a stacked bar chart image from the chart configuration supplied in the request body. The endpoint returns the rendered image as binary data.

Request Body

Parameter	Type	Mandatory	Description
title	String	Yes	Chart title. Must be at least 1 character.
data	Object Array	Yes	Array of stacked bar definitions. Each item must include `name` and `values`; `width` is optional.
data[].name	String	Yes	Label for the bar group.
data[].width	Integer	No	Bar width in pixels. Must be at least 1.
data[].values	Object Array	Yes	Stacked segments for the bar group. Each item must include `label` and `value`; `color` is optional.
data[].values[].color	String	No	6-character hex color without the leading `#` symbol. Must match `^[A-Fa-f0-9]{6}$`.
data[].values[].label	String	Yes	Segment label.
data[].values[].value	Number	Yes	Segment value.
bar	Object Array	No	Alias for `data`. Use either `data` or `bar`, not both. Each item follows the same shape as `data[]`. Deprecated.
bar[].name	String	Yes	Label for the bar group.
bar[].width	Integer	No	Bar width in pixels. Must be at least 1.
bar[].values	Object Array	Yes	Stacked segments for the bar group. Each item must include `label` and `value`; `color` is optional.
bar[].values[].color	String	No	6-character hex color without the leading `#` symbol. Must match `^[A-Fa-f0-9]{6}$`.
bar[].values[].label	String	Yes	Segment label.
bar[].values[].value	Number	Yes	Segment value.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
options	Object	No	Chart rendering options. See nested fields below.
options.width	Integer	No	Canvas width in pixels. Must be at least 1.
options.height	Integer	No	Canvas height in pixels. Must be at least 1.
options.x_axis	Object	No	X-axis text styling.
options.x_axis.font_size	Number	No	Font size in pixels. Must be at least 1.
options.x_axis.font_color	String	No	6-character hex color without the leading `#` symbol. Must match `^[A-Fa-f0-9]{6}$`.
options.y_axis	Object	No	Y-axis text styling.
options.y_axis.font_size	Number	No	Font size in pixels. Must be at least 1.
options.y_axis.font_color	String	No	6-character hex color without the leading `#` symbol. Must match `^[A-Fa-f0-9]{6}$`.
options.spacing	Integer	No	Space between bars in pixels. Must be at least 0.
options.bar_width	Integer	No	Bar width in pixels. Must be at least 1.
options.title_style	Object	No	Title text styling.
options.title_style.padding	Integer	No	Padding in pixels. Must be at least 0.
options.title_style.font_size	Number	No	Font size in pixels. Must be at least 1.
options.title_style.font_color	String	No	6-character hex color without the leading `#` symbol. Must match `^[A-Fa-f0-9]{6}$`.
options.canvas_color	String	No	6-character hex color without the leading `#` symbol. Must match `^[A-Fa-f0-9]{6}$`.
options.background_padding	Integer	No	Padding around the chart in pixels. Must be at least 0.

Response

Returns a binary response containing the generated chart image. The response schema is a single binary string rather than a JSON object.

Notes

The request body defines both data and a deprecated bar alias for the same stacked-bar array; use only one of them, not both. Several styling values are hex colors and must be provided without the leading # symbol.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.