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

# Generate SVG Badge API

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

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/download` | What it does Generates an SVG badge file from the provided badge text and optional color values, th… | 60 |
| POST | `/link` | What it does Generates a signed URL for an SVG badge. The request body supplies the badge label and… | 60 |

## About

## What it does
SVG Badge Generator creates simple SVG status badges from a label and message, with optional label and message colors. Send `label` and `message` in the request body to generate a badge for build status, package state, documentation coverage, or any other short label/value pair you want to display in a repo, README, or dashboard.

Use `label_color` and `message_color` when you need to match your product or project theme. The service supports two response styles: `POST /download` returns the SVG as binary content, and `POST /link` returns a signed URL in `data` so you can reference the generated badge elsewhere.

SVG badges are useful when you need lightweight, text-based visuals that stay sharp at any size and render well in GitHub READMEs, docs sites, CI output pages, and internal tools. Because the inputs are just strings, you can generate badges dynamically from pipeline results, environment labels, release states, or other short status values without managing image assets.

## Usage

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