---
title: "Discover current signed Run Cards for an artifact."
method: GET
path: "/api/artifacts/{id}/run-cards"
tags: ["Run Cards"]
---

# Discover current signed Run Cards for an artifact.

`GET /api/artifacts/{id}/run-cards`

## Request

- Base URL: `https://huggingbay.xyz`
- URL: `https://huggingbay.xyz/api/artifacts/{id}/run-cards`
- Auth: none declared

Returns only Run Cards independently revalidated against expiry, revocation, recorded executable state, signatures, and verified objects. The match is artifact-only; every card names its own exact rig and constraints and is not claimed to match the viewer's rig.

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

- `id` string, required

## Query parameters

- `limit` integer

## Response `200`

Current artifact-bound Run Cards

- RunCardDiscovery
  - `schemaVersion` 'hugging-bay.run-card-discovery.v1', required
  - `artifactId` string, required
  - `state` 'available' | 'unavailable', required
  - `matchClaim` 'artifact-only', required
  - `note` string, required
  - `cards` object[], required
    - `id` string, required
    - `decisionId` string, required
    - `task` string, required
    - `taskMode` string, nullable, required
    - `rig` object, required
      - `id` string, nullable, required
      - `profileDigest` string, nullable, required
    - `runtime` object, required
      - `adapterId` string, nullable, required
      - `engineVersion` string, nullable, required
      - `adapterVersion` string, nullable, required
    - `fit` object, required
      - `verdict` string, nullable, required
      - `evidenceLevel` string, nullable, required
      - `requiredBytes` integer, nullable, required
      - `headroomBytes` integer, nullable, required
    - `smoke` object, required
      - `passed` boolean, required
      - `passedAt` string, nullable, required
      - `suiteId` string, nullable, required
    - `representation` object, required
      - `artifactId` string, nullable, required
      - `representationId` string, nullable, required
      - `revision` string, nullable, required
      - `selectedFilesDigest` string, nullable, required
    - `evidenceCutoff` string, date-time, required
    - `expiresAt` string, date-time, required
    - `links` object, required
      - `html` string, required
      - `json` string, required

## Other responses

- `422`: Invalid artifact id, limit, or query parameter
- `503`: recorded Run Card discovery unavailable

---

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