Docs · Badges

Status badges for your README

Once you enable a monitor's public status page, three live SVG badges become available. Drop them into any README, dashboard, or wiki — they refresh every 60 seconds and stay accurate as long as the page is enabled.

Privacy note: badges only reveal data that's already on the public status page — current state, 90-day uptime, and 7-day p95 response time. They never include your test address or domain. If you want to hide everything, disable the public status page in the monitor's settings.

Status badge

One green/amber/red pill that reflects the monitor's current state.

Markdown

![status](https://mailflowmon.com/status/<your-token>/badge.svg)

HTML

<img alt="status" src="https://mailflowmon.com/status/<your-token>/badge.svg">

Endpoint

https://mailflowmon.com/status/<your-token>/badge.svg

Renders when at least one recent check failed but the failure threshold hasn't been crossed.

Renders when consecutive failures have crossed the alert threshold.

Uptime · 90 days

Percentage of probes that succeeded over the last 90 days.

Markdown

![uptime](https://mailflowmon.com/status/<your-token>/badge/uptime.svg)

HTML

<img alt="uptime" src="https://mailflowmon.com/status/<your-token>/badge/uptime.svg">

Colour rules:
● ≥ 99.5 % — green
● ≥ 95 % — amber
● < 95 % — red

Response time · 7-day p95

95th-percentile end-to-end delivery time over the last 7 days.

Markdown

![response](https://mailflowmon.com/status/<your-token>/badge/response.svg)

HTML

<img alt="response" src="https://mailflowmon.com/status/<your-token>/badge/response.svg">

Need to find your monitor's token? Open the monitor and click Edit — the canonical URL is in the Public status page section. Don't have one yet? Sign up — three monitors free.