---
title: "Fetch the negotiated Run Card surface headers without a body."
method: HEAD
path: "/run-cards/{id}"
tags: ["Run Cards"]
---

# Fetch the negotiated Run Card surface headers without a body.

`HEAD /run-cards/{id}`

## Request

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

Identical headers to GET (Content-Type, ETag, Cache-Control, Vary, Content-Length) with an empty body.

**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.** HEAD returns headers without a body. Use the HTTP status and Retry-After.

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

## Response `200`

Surface headers for the negotiated representation.

## Other responses

- `304`: Not modified (If-None-Match matched the current ETag).
- `404`: Unknown opaque card ID
- `405`: Method not allowed; only GET and HEAD are supported.
- `410`: Revoked
- `503`: Integrity or authoritative state 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/63c474bf0fe4?raw)