---
title: "Shields.io endpoint badge JSON"
method: GET
path: "/v1/badge/{slug}/{version}"
---

# Shields.io endpoint badge JSON

`GET /v1/badge/{slug}/{version}`

## Request

- Base URL: `https://api.endoflife.ai`
- URL: `https://api.endoflife.ai/v1/badge/{slug}/{version}`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer

Badges are answered before the quota check and never count against it. An unknown product or version gives a grey 'unknown' badge, not a 404.

## Path parameters

- `slug` string, required
- `version` string, required

## Response `200`

Shields.io endpoint schema: schemaVersion, label, message (score and band), color, cacheSeconds

---

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