---
title: "Get Public Share"
method: GET
path: "/shares/{token}"
tags: ["shares"]
---

# Get Public Share

`GET /shares/{token}`

## Request

- Base URL: `https://api.brickway.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brickway.app/shares/{token}`
- Auth: none declared

## Path parameters

- `token` string, required

## Response `200`

Successful Response

- PublicShareResponse: Public snapshot plus its frozen first-publication presentation theme. Explicit light/dark card variants are query overrides; the stored default is joined into this narrowly-shaped renderer response for bare URLs and OG.
  - `version` 1 | 2
  - `kind` 'item' | 'build_completed' | 'ordered' | 'mail_day' | 'new_addition' | 'wishlist' | 'active_build' | 'collection_milestone' | 'build_milestone' | 'figdex_milestone' | 'year_recap', required
  - `title` string, required
  - `subject` ShareSubjectV1
    - `catalog_kind` 'lego_set' | 'global_alt_set' | 'canonical_minifig', required
    - `name` string, required
    - `display_id` string, required
    - `catalog_ref` string, required
    - `set_num` string, nullable
    - `maker` string, required
    - `manufacturer_slug` string, required
    - `maker_url` string, uri, nullable
    - `image_ref` string, nullable
    - `year` integer, nullable
    - `pieces` integer, nullable
    - `quantity` integer, nullable
    - `retired` boolean, nullable
    - `custom_visibility` 'global', nullable
    - `verified_amazon_asin` string, nullable
  - `moment_at` string, date-time, nullable
  - `moment_tz` string, nullable
  - `build` ShareBuildV1
    - `tracking_fidelity` 'active' | 'calendar' | 'untimed' | 'imported', required
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `active_seconds` integer, nullable
    - `piece_count` integer, nullable
    - `active_status` 'building' | 'paused', nullable
  - `achievement` ShareAchievementV1: Frozen, database-derived milestone/recap facts. The values are deliberately generic and numeric/string-only. No tenant identifiers or free-form household text can enter the public contract.
    - `achievement_kind` 'collection_sets' | 'collection_pieces' | 'completed_builds' | 'built_pieces' | 'cmf_series' | 'year_recap', required
    - `achievement_key` string, required
    - `threshold` integer, nullable
    - `current_count` integer, nullable
    - `series_name` string, nullable
    - `year` integer, nullable
    - `sets_built` integer, nullable
    - `pieces_built` integer, nullable
    - `hands_on_seconds` integer, nullable
  - `template_version` 1, nullable
  - `card_theme` 'light' | 'dark', required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brickway/apis/brickway-api.md) · [All operations](https://skmtc.dev/brickway/apis/brickway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brickway/apis/brickway-api/revisions/643a9d231869?raw)