---
title: "Scan Badge"
method: GET
path: "/api/v1/public/scan/{owner}/{repo}/badge"
tags: ["public-scan"]
---

# Scan Badge

`GET /api/v1/public/scan/{owner}/{repo}/badge`

## Request

- Base URL: `https://agentavow.com` (the document declares no server; this is the origin it was published from)
- URL: `https://agentavow.com/api/v1/public/scan/{owner}/{repo}/badge`
- Auth: none declared

Return an SVG badge for README embedding.

``style`` picks the look from the shared badge design system
(``src.api.badge_avow``): ``compact`` (default) is the 20px README badge with the
trust and adoption meters; ``card`` is the website-embed card as an image;
``classic`` is the previous shields-style pill. ``theme`` (auto / light / dark)
pins the colours; ``auto`` follows the viewer's colour scheme.
``metric=adoption`` keeps the adoption-only classic badge.

``metric=trust`` (default) shows the signed grade — the composite trust score
when the repo is imported ("Trust: A 92"), else the security scan ("Scan: B 74").
``metric=adoption`` shows the real adoption headline ("Adopted: 22.6k ★"), or
"new" when there's no independent-reliance signal yet.

Usage in markdown:
```
![Trust](https://agentavow.com/api/v1/public/scan/owner/repo/badge)
![Adoption](https://agentavow.com/api/v1/public/scan/owner/repo/badge?metric=adoption)
```

## Path parameters

- `owner` string, required
- `repo` string, required

## Query parameters

- `metric` string
- `style` string
- `theme` string

## Response `200`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentavow/apis/agentavow-api.md) · [All operations](https://skmtc.dev/agentavow/apis/agentavow-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentavow/apis/agentavow-api/revisions/e1e20476dbfc?raw)