---
title: Generate Bar Graph API
slug: generate-simple-bar-chart
url: https://apyverse.com/apyhub/service/generate-simple-bar-chart
provider: ApyHub
categories: [Image Processing, Smart Generation]
tags: [bar-chart, data-visualization, chart-rendering, image-generation, reporting]
auth: api_key
---

# Generate Bar Graph API

Generate bar chart images from title and labeled values. Get a binary image or a pre-signed URL for dashboards, reports, and summaries.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `generate/charts/bar/file` | What it does Generates a bar chart image from the request body and returns the rendered image as bi… | 60 |
| POST | `generate/charts/bar/url` | What it does Generates a bar chart and returns a URL to the created chart image. The request body s… | 60 |

## About

## What it does
Simple Bar Chart generates bar chart images from a title and a list of bar values. Send `title` and `data`, where each item includes `label` and `value`; you can also include an optional `color` for each bar. Use `theme` to switch between `light` and `dark`, and fine-tune the output with `options` such as `width`, `height`, `spacing`, `bar_width`, `background`, `title_style`, `x_axis`, `y_axis`, and `canvas_color`.

Use `POST /download` when you want the rendered chart back as binary image data. Use `POST /link` when you want a pre-signed URL to the generated chart image. That makes this useful for dashboards, reports, admin panels, and internal tools that need charts without building chart rendering into the application.

Simple Bar Chart is a good fit when your data is already aggregated and you need a quick visual summary by category. A sales report, product comparison, regional breakdown, or usage snapshot can be turned into a shareable chart with just a few fields.

The request schema is strict: bar entries only accept `label`, `value`, and optional `color`, and `options` only accepts the documented layout and color settings. The response from `/link` is a single `data` URL field; `/download` returns the image itself.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyverse.com/apyhub/service/generate-simple-bar-chart