---
title: "Stream one image of a stack share"
method: GET
path: "/api/public/stack-shares/{code}/images/{imageId}"
tags: ["Sharing"]
---

# Stream one image of a stack share

`GET /api/public/stack-shares/{code}/images/{imageId}`

## Request

- Base URL: `https://www.stackerscan.com`
- URL: `https://www.stackerscan.com/api/public/stack-shares/{code}/images/{imageId}`
- Auth: none required

The image bytes themselves, streamed after a fresh check that the link is still active and the image is still the share's own — not a storage URL, and never cacheable (`no-store`, `Accept-Ranges: none`). `If-None-Match` is honoured with a `304` after that same check. This is the only image path: there is no direct storage access behind a share.

## Path parameters

- `code` string, required
- `imageId` string, uuid, required

## Query parameters

- `variant` 'full' | 'thumbnail'
- `download` 'true' | 'false'

## Response `200`

The image bytes, with `Content-Type` naming the stored format.

## Other responses

- `304`: The recipient's cached copy is still current. No body.
- `400`: A parameter was missing or outside its accepted values. `type` is `missing-parameter` or `invalid-parameter`, and `detail` names the parameter.
- `404`: The link is unknown, expired, revoked or its target no longer exists — one answer for all four, with no owner or lifecycle detail. Also the answer for an image id that is not this share's own.
- `429`: A per-caller budget is exhausted: distinct codes tried, or requests of this kind, within a rolling window. `Retry-After` says when the exhausted window admits another request.
- `500`: The request was well formed but could not be served. Retrying later may succeed.
- `503`: The rate-limit protection or the share's authority could not be established, so the request was refused without looking anything up. The link is not invalidated; retry after `Retry-After`.

---

[API](https://skmtc.dev/stackerscan/apis/stackerscan-public-api.md) · [All operations](https://skmtc.dev/stackerscan/apis/stackerscan-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stackerscan/apis/stackerscan-public-api/revisions/476d2eaffc90?raw)