---
title: "Fetch recorded public evidence as JSON or another parity-checked representation."
method: GET
path: "/api/public-evidence/artifacts/{artifactId}"
tags: ["Run Cards"]
---

# Fetch recorded public evidence as JSON or another parity-checked representation.

`GET /api/public-evidence/artifacts/{artifactId}`

## Request

- Base URL: `https://huggingbay.xyz`
- URL: `https://huggingbay.xyz/api/public-evidence/artifacts/{artifactId}`
- 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 json; 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.** API JSON failures use the documented response schema. Read code, message and next; retry only when the response allows it. Auth, invalid input and missing records need a caller change.

**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)