---
title: "Fetch the digest-bound public execution status badge."
method: GET
path: "/badges/will-it-run/{artifactId}.svg"
tags: ["Run Cards"]
---

# Fetch the digest-bound public execution status badge.

`GET /badges/will-it-run/{artifactId}.svg`

## Request

- Base URL: `https://huggingbay.xyz`
- URL: `https://huggingbay.xyz/badges/will-it-run/{artifactId}.svg`
- Auth: none declared

Public, read-only projection of existing server-owned Run Card, accepted-run proof, rescue, request, and agent-action authorities. The default representation is badge; format or Accept negotiation can select any declared representation. Every representation is derived from one recorded projection, preserves evidence digests, freshness and uncertainty, and fails closed without inferring throughput, compatibility, success, geography, or license safety.

**Inputs.** Path, query and header fields are listed below. No request body is required.

**Outputs.** See each status below for its media type, schema and headers. A missing record or unavailable capability is not a successful empty result.

**Errors.** Read the status and Content-Type before decoding. Document, image, redirect and file routes need not return JSON errors.

**Rate limits.** Public read budgets apply by client IP and route group. This operation can have a smaller route-specific budget. Read Retry-After on 429 or retryable 503 responses.

**Example setup.** Use an identifier returned by the matching list, search or create operation. Sample identifiers are not a promise that a record exists.

## Path parameters

- `artifactId` string, required

## Query parameters

- `format` 'html' | 'json' | 'jsonld' | 'mcp' | 'citation' | 'markdown' | 'share' | 'badge'

## Response `200`

One bounded representation of the recorded public evidence projection.

- union
  - PublicEvidenceSurface
    - `schema` 'hugging-bay.public-evidence-surface.v1', required
    - `artifactId` string, required
    - `canonicalUrl` string, uri, required
    - `apiUrl` string, uri, required
    - `generatedAt` string, date-time, required
    - `selection` object, required
      - `scope` 'artifact-only', required
      - `activeRigMatch` unknown, required
      - `selectedCardId` string, nullable, required
      - `state` 'available' | 'unavailable', required
      - `reason` string, required
    - `readiness` object, required
      - `status` 'verified' | 'runnable' | 'failed' | 'blocked' | 'unknown', required
      - `reason` string, required
      - `runnable` boolean, required
      - `verified` boolean, required
      - `rescueStatus` string, nullable
      - `reasonCodes` string[], required
      - `primaryAction` object, nullable, required
    - `runCard` object, nullable, required
    - `proof` object, required
    - `rescue` object, required
    - `evidenceContext` object, required
      - `uncertainty` object, required
      - `blockers` object, required
      - `freshness` object, required
    - `requests` object, required
    - `claims` PublicEvidenceClaim[], required
      - `id` string, required
      - `label` string, required
      - `value` string, required
      - `evidenceSource` string, required
      - `evidenceDigest` string, nullable, required
      - `timestamp` string, date-time, required
      - `canonicalVerificationUrl` string, uri, required
      - `citationId` string, required
      - `digest` string, required
    - `distribution` object, required
      - `json` string, uri, required
      - `jsonLd` string, uri, required
      - `mcp` string, uri, required
      - `citation` string, uri, required
      - `share` string, uri, required
      - `badge` string, uri, required
      - `runCard` string, uri, nullable, required
      - `acceptedRunProof` string, uri, nullable, required
    - `snippets` object, required
      - `cli` string, nullable, required
      - `cliSignedBase` string, nullable, required
      - `api` string, required
      - `mcp` string, required
      - `requestContract` string, required
    - `surfaceDigest` string, required
  - object: Digest-bound citation or share projection selected with the format parameter.

## Other responses

- `304`: The selected representation matches If-None-Match.
- `404`: The route identifier is malformed, sensitive-looking, or unavailable for public projection.
- `405`: Method not allowed; public evidence is GET/HEAD only.
- `406`: The requested representation format is unsupported.
- `422`: Unknown, duplicate, or otherwise invalid query parameters.
- `429`: Public read rate limit exceeded.
- `503`: A bounded authority read failed closed, admission capacity was reserved, or the selected representation exceeded its response limit.

---

[API](https://skmtc.dev/huggingbay/apis/hugging-bay-public-api.md) · [All operations](https://skmtc.dev/huggingbay/apis/hugging-bay-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/huggingbay/apis/hugging-bay-public-api/revisions/ea7ba26b1e27?raw)