Add a live health score badge to your README

One line of Markdown. Your grade updates automatically after every scan. Signals code quality to contributors, users, and hiring managers instantly.

Quick start

Paste your GitHub repo URL in the playground to get a grade. Or buy a full scan from $29.

Replace owner/repo with your GitHub repo path.

Markdown (README.md)

[![GateTest](https://gatetest.ai/api/badge?repo=owner/repo)](https://gatetest.ai/playground)

HTML

<a href="https://gatetest.ai/playground"><img src="https://gatetest.ai/api/badge?repo=owner/repo" alt="GateTest"></a>

reStructuredText

.. image:: https://gatetest.ai/api/badge?repo=owner/repo
   :target: https://gatetest.ai/playground
   :alt: GateTest

The badge updates automatically after every GateTest scan. No re-configuration needed.

Parameter	Description
repo	GitHub repo in `owner/name` format (required)
style	Badge style — `flat` (default) or `shields`

Endpoint: GET https://gatetest.ai/api/badge?repo=owner/repo

Cache: 5 minutes (CDN) · Stale-while-revalidate

🏷️

Contributors and users see your code quality grade before they read a single line of code.

🔄

The badge reflects the latest completed scan. Run a scan → badge updates. No manual steps.

📈

A declining grade is visible to everyone. Teams with a public badge fix issues faster.

Ready to earn your badge?