Skip to main content

How the security badge works

The badge is a small SVG served from /api/badge/<domain>. Each request reads the domain's latest quick scan (the same one behind the homepage and the scan report), turns the result into a grade from A+ to F and a percentage, and draws it in the colour of that grade. Because it is a plain image URL it works in an HTML page, a GitHub README, a documentation site or an email signature, and it links back to the full report so a visitor can see exactly what was checked.

What the grade reflects: DNS records and DNSSEC, the email-authentication stack (SPF, DKIM, DMARC, MTA-STS, BIMI), mail-server transport security and a set of web security signals. The methodology page explains the checks and the scoring. A badge is only worth showing while it is true, so it is generated from the domain's current scan result rather than stored as a fixed image: when a record breaks and the domain is rescanned, the badge follows.

Domains that score 70% or higher and show the badge on their own site can be listed in the verified domains directory.

Grades and colours

Badge FAQ

What does the IntoDNS.ai security badge show?
An SVG with the letter grade and percentage from the IntoDNS.ai quick scan of the domain, for example A (92%). The colour follows the grade, from green for A+ down to red for F, and the large style adds a one-word label such as Excellent or Poor. Clicking it opens the full scan report.
How current is the score on the badge?
The badge is generated from the same cached quick scan as the scan page and the image itself is cached for up to an hour. After you fix a DNS record, rescan the domain and the badge follows within about an hour.
Which badge styles are there?
Four: flat, flat-square and plastic, which are 150 by 20 pixel strips for footers and READMEs, and large, a 200 by 100 pixel card with the grade, the percentage and its label for sidebars.
How do I put the badge in a GitHub README or on my site?
Generate it for your domain above and copy the HTML or Markdown snippet. Both link the image to your scan report on intodns.ai. The image URL has the form https://intodns.ai/api/badge/yourdomain.com?style=flat and needs no API key.
Does the badge cost anything or need an account?
No. Badges are free and need no signup. If your domain scores 70% or higher and you place the badge on your site, you can also be listed in the verified domains directory.