▣ IMAGE PROCESSING · SMART GENERATION

Bar Chart Generator

Hosted on ApyHub

What it does

Bar Chart Generator creates a bar chart image from your data and returns it as either a pre-signed image URL or a binary download, depending on the endpoint you use.

Send a title and a data array of bar objects. Each bar can include a label, value, and optional color as a 6-character hex value without #. You can also set theme to light or dark, and fine-tune the chart with options such as width, height, axis font sizes and colors, spacing, bar width, background padding and color, title styling, and canvas color.

Use it when you need charts for dashboards, reports, email exports, admin panels, or generated documents. The same input structure works whether you want a shareable chart link from /link or a direct image file from /download.

Bar Chart Generator is a fit for applications that need consistent, programmatic chart rendering without building chart logic in the client.

▣ ENDPOINT 01 / 02

POST

Generate bar chart link

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

QUICKSTART

GUIDE

Quickstart

Generate a bar chart image URL from a title and a list of bar values.

curl -X POST "https://api.eu.apyverse.com/deepak/generate-bar-chart/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Quarterly Sales by Region","data":[{"color":"3B82F6","label":"North America","value":42000},{"color":"10B981","label":"Europe","value":37500},{"color":"F59E0B","label":"Asia Pacific","value":28900}]}'

What you'll get back

Returns a JSON object with a data string field containing a URI for the generated chart image.

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

TRY ITLIVE · 10 ATOMS

Loading playground…

About this endpoint

What it does

Generates a bar chart and returns a pre-signed URL for the generated chart image. The request body includes the chart title, bar data, and optional styling/options; the response returns the URL in a JSON object.

Request Body

Parameter	Type	Mandatory	Description
title	String	Yes	Chart title.
data	Object Array	Yes	Canonical list of bar values. Each item must include `label` and `value`; `color` is optional and must be a 6-character hex color without the leading `#` symbol.
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	Deprecated alias for `data`. Use either `data` or `bars`, not both. Each item must include `label` and `value`; `color` is optional and must be a 6-character hex color without the leading `#` symbol.
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`.
options	Object	No	Chart styling and layout options. See 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 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 JSON object with a data string field. The data value is a URI for the generated chart image.

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

Parameters

No parameters.

▣ ENDPOINT 02 / 02

POST

Generate bar chart image

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

QUICKSTART

GUIDE

Quickstart

Generate a bar chart image from a minimal set of bar data and save it using the output query parameter.

curl -X POST "https://api.eu.apyverse.com/deepak/generate-bar-chart/download?output=quarterly-sales-bar-chart" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quarterly Sales by Region",
    "data": [
      { "color": "3B82F6", "label": "North America", "value": 42000 },
      { "color": "10B981", "label": "Europe", "value": 37500 },
      { "color": "F59E0B", "label": "Asia Pacific", "value": 28900 }
    ]
  }'

What you'll get back

Returns a binary file (string with format: "binary"), not a JSON object.

TRY ITLIVE · 10 ATOMS

Loading playground…

About this endpoint

What it does

Generates a bar chart image from the chart configuration you send in the request body, then returns the rendered image as binary data.

Request Body

Parameter	Type	Mandatory	Description
title	String	Yes	Chart title. Minimum length: 1.
data	Object Array	Yes	Canonical list of bar values. Must contain at least 1 item.
data[].color	String	No	Bar color as a 6-character hex value 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.
bars[].color	String	No	Bar color as a 6-character hex value 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`.
options	Object	No	Chart styling and layout 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	X-axis font color as a 6-character hex value 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	Y-axis font color as a 6-character hex value 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	Background color as a 6-character hex value 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	Title font color as a 6-character hex value without the leading `#` symbol.
options.canvas_color	String	No	Canvas color as a 6-character hex value without the leading `#` symbol.

Response

Returns a binary response containing the generated chart image. The success response is a single binary payload, not a JSON object.

Attribute	Type	Mandatory	Description
binary	Binary	Yes	Rendered bar chart image.

Notes

The request body supports both data and the deprecated bars alias for the bar list, but the schema indicates data is the canonical field. Use data for new integrations, and note that data must contain at least one item.

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.