---
title: SVG Badge Generator
slug: generate-svg-badge
url: https://apyverse.com/apyhub/service/generate-svg-badge
provider: ApyHub
categories: [Developer Tools, Smart Generation]
tags: [svg-badges, badge-generation, svg-generation, developer-tools, documentation]
auth: api_key
---

# SVG Badge Generator

Generate SVG badges from a label and message, with optional colors. Download the SVG or get a signed URL for docs, CI, and readme badges.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/download` | What it does Generates an SVG badge and returns it as a downloadable binary response. The request b… | 10 |
| POST | `/link` | What it does Generates a signed URL for an SVG badge from the provided badge label and message, and… | 10 |

## About

## What it does
SVG Badge Generator creates a simple two-part SVG badge from a label and a message. Send a `label` for the left side and a `message` for the right side, with optional `label_color` and `message_color` values to control each section’s hex color.

Use it when you need status badges for README files, CI pipelines, package pages, or internal dashboards. The badge is returned either as a binary SVG download from `POST /download` or as a signed URL from `POST /link`, depending on how you want to fetch and store the result.

The API keeps the response minimal: the download endpoint returns the generated SVG file, while the link endpoint returns a `data` field containing a signed URI to that SVG. That makes it easy to generate badges on demand without building your own SVG templating or storage flow.

If you need consistent build, release, or environment labels across docs and tools, this service gives you a direct way to generate the badge asset from a small JSON body.

## Usage

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