Voidly Status Badges
Like shields.io, but for censorship data. Drop-in SVG badges for READMEs, blogs, and docs that show whether a country, service, or domain is blocked — refreshed every five minutes from 2,021 live incidents.
Build your badge
Pick a kind, fill in the blanks, copy the snippet.
[](https://voidly.ai/ir)
<a href="https://voidly.ai/ir"><img src="https://api.voidly.ai/badge/v1/country/IR.svg" alt="Censorship level in IR" /></a>
.. image:: https://api.voidly.ai/badge/v1/country/IR.svg :target: https://voidly.ai/ir :alt: Censorship level in IR
image:https://api.voidly.ai/badge/v1/country/IR.svg[Censorship level in IR,link=https://voidly.ai/ir]
URL patterns
All badges live under https://api.voidly.ai/badge/v1/. Each endpoint returns an SVG with Cache-Control: public, max-age=300 and Access-Control-Allow-Origin: *.
| Pattern | Description | Example |
|---|---|---|
| /badge/v1/country/<CC>.svg | Country severity tier + score | |
| /badge/v1/service/<name>/<CC>.svg | Status of a named service in a country | |
| /badge/v1/domain/<host>/<CC>.svg | Block status for any domain in a country | |
| /badge/v1/voidly.svg | Generic “Tracked by Voidly · N incidents” | |
| /badge/v1/incident/<id>.svg | Severity for a single citable incident |  |
| /badge/v1/topic/<topic>.svg | How many countries censor this topic |  |
Query parameters (all optional)
?style=flat-square(default),flat,plastic, orfor-the-badge?label=override the left-side text (URL-encoded)?color=override the right-side colour: a hex (#10b981) or a name (red,severe,accessible, …)?logo=nonehide the inline V mark
Examples gallery
Five common ways people use Voidly badges. Click the snippet to copy the markdown.
Show your project is censored somewhere
Drop-in badge for tools, news sites, or apps that face blocking. Pulls live data from /data/censorship-index.json.
Show that an AI service is blocked
Aliases for OpenAI, Claude, Gemini, Perplexity and more — resolves to the right domain automatically.
Pin a domain status to your README
For news sites, indie SaaS, or any domain — pass a fully qualified host plus a country code.
Tracked-by-Voidly badge
For projects that consume Voidly data — say so loudly. Auto-updates with our live incident counter.
Topic-level signal
Counts countries with non-zero censorship score in a Citizen Lab category. Drives advocacy dashboards.
How it works
Released under CC BY 4.0. Attribution: link back to voidly.ai.
Need a badge that doesn’t exist yet? Open an issue on GitHub or email us.