Badge API

Quick Start

Drop a badge into any Markdown file. It updates automatically.

![Python EOL](https://img.releaserun.com/badge/eol/python.svg)
![Node.js Version](https://img.releaserun.com/badge/v/nodejs.svg)
![Kubernetes Health](https://img.releaserun.com/badge/health/kubernetes.svg)

URL Format

https://img.releaserun.com/badge/{type}/{product}.svg
https://img.releaserun.com/badge/{type}/{product}/{version}.svg

The .svg extension is required. All badges return SVG with proper CORS headers for embedding anywhere.

Version-Specific Badges NEW

Pin badges to the exact version your project uses. Much more useful than generic "latest version" badges.

![Node.js 22](https://img.releaserun.com/badge/health/nodejs/22.svg)
![Python 3.12](https://img.releaserun.com/badge/health/python/3.12.svg)
![PostgreSQL 16](https://img.releaserun.com/badge/health/postgresql/16.svg)

Or generate them automatically with the CLI:

npx releaserun badges       # scan project, copy badge markdown to clipboard
npx releaserun readme --write  # inject badges into your README automatically

Badge Types

🟢 Health

Overall release health score based on version age, CVE count, and EOL proximity.

/badge/health/{product}.svg

📅 End of Life

Shows EOL date and how long until support ends. Turns red when EOL is approaching.

/badge/eol/{product}.svg

🏷️ Version

Latest stable version number. Updates automatically on new releases.

/badge/v/{product}.svg

🛡️ CVE Count

Known CVE count for the latest version. Color-coded by severity.

/badge/cve/{product}.svg

☁️ Cloud

Cloud provider support status for major platforms.

/badge/cloud/{product}.svg

Supported Technologies

300+ products supported. Here are the most popular ones:

For the full list of 300+ supported products, visit the Badge Generator tool.

Usage Examples

Version-Specific README (Recommended)

# My Project

[![Node.js 22 Health](https://img.releaserun.com/badge/health/nodejs/22.svg)](https://releaserun.com/nodejs/22/)
[![Python 3.12 Health](https://img.releaserun.com/badge/health/python/3.12.svg)](https://releaserun.com/python/3.12/)
[![PostgreSQL 16 Health](https://img.releaserun.com/badge/health/postgresql/16.svg)](https://releaserun.com/postgresql/16/)

Badges show health grades for the versions YOUR project actually uses.

Generic Badges

# My Project

![Python](https://img.releaserun.com/badge/v/python.svg)
![Node.js](https://img.releaserun.com/badge/v/nodejs.svg)
![Docker](https://img.releaserun.com/badge/health/docker-engine.svg)

Show the latest stable version across the ecosystem.

HTML (Docs, Dashboards)

<img src="https://img.releaserun.com/badge/eol/python.svg" alt="Python EOL status">
<img src="https://img.releaserun.com/badge/cve/kubernetes.svg" alt="Kubernetes CVE count">

reStructuredText (Sphinx Docs)

.. image:: https://img.releaserun.com/badge/v/python.svg
   :alt: Python version
   :target: https://releaserun.com/python/

AsciiDoc

image:https://img.releaserun.com/badge/health/kubernetes.svg[Kubernetes Health, link="https://releaserun.com/kubernetes/"]

Shields.io Style Combo

Combine ReleaseRun badges with shields.io for a consistent look:

[![Build](https://img.shields.io/github/actions/workflow/status/org/repo/ci.yml)](...)
[![Python](https://img.releaserun.com/badge/v/python.svg)](https://releaserun.com/python/)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

Technical Details

Rate Limits

2,000 requests per minute. Badges are cached server-side (TTL varies by type). No API key or signup needed.

Response Format

All badges return image/svg+xml with proper cache headers and CORS (Access-Control-Allow-Origin: *).

Data Sources

Version and EOL data from endoflife.date API, enriched with CVE data from NVD and cloud provider compatibility matrices.

Uptime

Badge service runs on dedicated infrastructure. Current uptime >99.9%.

GitHub Action v2

Automate version checks in your CI pipeline with the ReleaseRun GitHub Action:

- name: Check stack health
  uses: Releaserun/releaserun-action@v2
  with:
    path: '.'
    comment: 'true'
    fail-on: 'F'

v2 detects versions from your project files (package.json, Dockerfile, go.mod, requirements.txt, Cargo.toml, docker-compose.yml) and generates version-specific badge markdown in PR comments.

Auto-Update README Badges

- name: Update README badges
  uses: Releaserun/releaserun-action@v2
  with:
    path: '.'
    update-readme: 'true'

Automatically commits updated version-specific badges to your README on every PR.

CLI Tool v1.4

Scan any project directory and get version-specific badges instantly:

# Scan project and generate badge markdown
npx releaserun badges

# Inject badges into your README (between markers)
npx releaserun readme --write

# Full health check with grades
npx releaserun check

The CLI reads package.json, Dockerfile, go.mod, requirements.txt, Cargo.toml, composer.json, Gemfile, pom.xml, docker-compose.yml, .nvmrc, .python-version, and .tool-versions to detect what your project actually uses.

Source: github.com/Releaserun/releaserun-cli | npm

More Free Tools

Badges are just one of 30+ free developer tools:

View all 30+ tools