---
title: "The upvote badge as an SVG image"
method: GET
path: "/api/badge/{toolId}.svg"
---

# The upvote badge as an SVG image

`GET /api/badge/{toolId}.svg`

## Request

- Base URL: `https://brofindai.com`
- URL: `https://brofindai.com/api/badge/{toolId}.svg`
- Auth: none declared

For READMEs and anywhere a maker can drop an <img> but not a <script>. Carries its own copy of Figtree as an embedded subset, because an <img>-embedded SVG loads no external resource. Colours are fixed brand colours and are not a parameter. Shader backgrounds are unavailable here (a static image runs no JavaScript) and degrade to the flat themed card.

## Path parameters

- `toolId` string, required

## Query parameters

- `theme` 'auto' | 'light' | 'dark'
- `size` 'compact' | 'standard' | 'large'

## Response `200`

The badge.

## Other responses

- `404`: No approved listing has that id. A badge is still rendered.

---

[API](https://skmtc.dev/brofindai/apis/bro-find-ai-api.md) · [All operations](https://skmtc.dev/brofindai/apis/bro-find-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brofindai/apis/bro-find-ai-api/revisions/4e4078821728?raw)