Generate Bar Graph API

Hosted on ApyHub

What it does

Bar Chart Generator creates bar chart images and shareable chart links from a title and a list of bar values. Send a title, data array, and optional theme or options; get back either a binary image from /download or a pre-signed image URL from /link.

Each bar item can include a label, value, and optional color hex code. The options object lets you control the chart size, spacing, bar width, axis font size and color, background padding and color, title styling, and canvas color. Use theme to switch between light and dark output.

This is a fit when you need charts for dashboards, reports, internal admin pages, or generated documents without rendering them in the browser. For example, you can turn quarterly sales by region, usage totals, or category counts into a consistent bar chart image for email, PDF, or a web app preview.

Bar Chart Generator keeps the payload simple and the output predictable: a chart image file or a URL pointing to the generated image.

▣ ENDPOINT 01 / 02

POST

Generate bar chart image

http://localhost:8080/apyhub/generate-bar-graph/download

QUICKSTARTGUIDE

Quickstart

Generate a bar chart image from a minimal JSON payload.

curl -X POST "http://localhost:8080/apyhub/generate-bar-graph/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quarterly Sales by Region",
    "data": [
      { "label": "North America", "value": 42000 }
    ]
  }'

What you'll get back

Returns a binary file response which is the generated bar graph image.

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.

body*

bars

Alias for data. Use either data or bars, not both.

data*

Canonical list of bar values.

data-1*

color

6-character hex color without the leading # symbol.

label*

value*

theme

Chart theme.

title*

options

width

Chart width in pixels.

height

Chart height in pixels.

x_axis

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

y_axis

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

spacing

Spacing in pixels.

bar_width

Bar width in pixels.

background

color

6-character hex color without the leading # symbol.

padding

Padding in pixels.

title_style

padding

Padding in pixels.

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

canvas_color

6-character hex color without the leading # symbol.

output

About this endpoint

What it does

Generates a bar chart image from the chart configuration in the request body and returns the image as binary data.

Request Body

Parameter	Type	Mandatory	Description
data	Object Array	Yes	Canonical list of bar values. Each item supports `label` and `value`, and may include `color`. Requires at least 1 item.
data[].color	String	No	6-character hex color without the leading `#` symbol.
data[].label	String	Yes	Bar label.
data[].value	Number	Yes	Bar value.
bars	Object Array	No	Alias for `data`. Deprecated. Use either `data` or `bars`, not both. Each item supports `label` and `value`, and may include `color`.
bars[].color	String	No	6-character hex color without the leading `#` symbol.
bars[].label	String	Yes	Bar label.
bars[].value	Number	Yes	Bar value.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Yes	Chart title. Must be at least 1 character.
options	Object	No	Chart layout and styling options.
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.
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 `#` symbol.
options.y_axis	Object	No	Y-axis styling options.
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 `#` symbol.
options.spacing	Integer	No	Spacing in pixels. Minimum: 0.
options.bar_width	Integer	No	Bar width in pixels. Minimum: 1.
options.background	Object	No	Background styling options.
options.background.color	String	No	6-character hex color without the leading `#` symbol.
options.background.padding	Integer	No	Padding in pixels. Minimum: 0.
options.title_style	Object	No	Title styling options.
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 `#` symbol.
options.canvas_color	String	No	6-character hex color without the leading `#` symbol.

Response

Returns a binary response body containing the generated chart image.

Notes

bars is a deprecated alias for data. Use one or the other, not both.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 02 / 02

POST

Generate bar chart link

http://localhost:8080/apyhub/generate-bar-graph/link

QUICKSTARTGUIDE

Quickstart

Generate a bar chart image from a small set of bar values.

curl -X POST "http://localhost:8080/apyhub/generate-bar-graph/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quarterly Sales by Region",
    "data": [
      { "label": "North America", "value": 42000, "color": "3B82F6" },
      { "label": "Europe", "value": 37500, "color": "10B981" },
      { "label": "Asia Pacific", "value": 28900, "color": "F59E0B" }
    ]
  }'

What you'll get back

Returns a JSON object with a data string field containing a pre-signed URI for 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.

body*

bars

Alias for data. Use either data or bars, not both.

data*

Canonical list of bar values.

data-1*

color

6-character hex color without the leading # symbol.

label*

value*

theme

Chart theme.

title*

options

width

Chart width in pixels.

height

Chart height in pixels.

x_axis

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

y_axis

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

spacing

Spacing in pixels.

bar_width

Bar width in pixels.

background

color

6-character hex color without the leading # symbol.

padding

Padding in pixels.

title_style

padding

Padding in pixels.

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

canvas_color

6-character hex color without the leading # symbol.

output

About this endpoint

What it does

Generates a bar chart link from the chart configuration in the request body and returns a JSON object containing a pre-signed URL for the generated chart image.

Request Body

Parameter	Type	Mandatory	Description
data	Object Array	Yes	Canonical list of bar values. Each item represents one bar and must include `label` and `value`; `color` is optional.
data[].color	String	No	6-character hex color without the leading `#` symbol.
data[].label	String	Yes	Label for the bar.
data[].value	Number	Yes	Numeric value for the bar.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Yes	Chart title.
options	Object	No	Chart options. See the nested fields below.
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 label styling. See the nested fields below.
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 `#` symbol.
options.y_axis	Object	No	Y-axis label styling. See the nested fields below.
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 `#` symbol.
options.spacing	Integer	No	Spacing in pixels. Minimum: 0.
options.bar_width	Integer	No	Bar width in pixels. Minimum: 1.
options.background	Object	No	Background styling. See the nested fields below.
options.background.color	String	No	6-character hex color without the leading `#` symbol.
options.background.padding	Integer	No	Padding in pixels. Minimum: 0.
options.title_style	Object	No	Title styling. See the nested fields below.
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 `#` symbol.
options.canvas_color	String	No	6-character hex color without the leading `#` symbol.

Response

Returns a JSON object with a data string field containing a URI. This data value is a pre-signed URL for 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

—

▣ 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.