---
title: "Read variant-aware public HTTPS product media without attachments"
method: GET
path: "/v1/media"
---

# Read variant-aware public HTTPS product media without attachments

`GET /v1/media`

## Request

- Base URL: `https://agent-commerce.homebridgepc.com`
- URL: `https://agent-commerce.homebridgepc.com/v1/media`
- Auth: none declared

Shopify remains authoritative. Variant association does not verify exact visual depiction; preserve relationship and fidelityNote. JSON is default; format=html is a browser gallery fallback. Rendering is client-dependent. No downloads or commerce mutations are required.

## Query parameters

- `category` 'fire_pits' | 'garden_beds' | 'mini_greenhouses' | 'culvert_covers' | 'retaining_wall_garden_beds', required
- `productHandle` string, required
- `sku` string
- `limit` integer
- `mediaTypes` string
- `format` 'json' | 'html'

## Response `200`

Shopify media with identity, fidelity, dimensions, and public URLs

- object
  - `galleryUrl` string, uri, required
  - `selectedVariant` object, nullable, required: Exact Shopify SKU, variant IDs, options, price and availability when sku is supplied.
  - `media` ProductMedia[], required
    - `relevance` object
      - `group` 'selected_variant' | 'matching_visual_attributes' | 'product_family', required
      - `evidenceSource` 'shopify_variant_association' | 'shopify_variant_options' | 'product_membership', required
      - `matchedAttributes` object, required
      - `differingAttributes` object, required
      - `reviewedDuplicateGroup` string
    - `url` string, nullable, required
    - `mimeType` string, nullable, required
    - `width` number, nullable, required
    - `height` number, nullable, required
    - `relationship` 'representative' | 'product_family', required
    - `association` 'shopify_variant_featured_image' | 'shopify_product_media', required
    - `associatedVariantIds` string[], required
    - `exactVariantDepictionVerified` false, required
    - `fidelityNote` string, required
    - `mediaId` string, nullable, required
    - `type` 'image' | 'video' | 'external_video' | 'model_3d', required
    - `position` integer, required
    - `altText` string, required
    - `previewImage` object, nullable, required
      - `url` string, required
      - `width` number, nullable, required
      - `height` number, nullable, required
    - `sources` object[], required
      - `url` string, required
      - `mimeType` string, nullable, required
      - `format` string, nullable, required
      - `width` number, nullable, required
      - `height` number, nullable, required
    - `embeddedUrl` string, nullable, required

## Other responses

- `400`: Invalid media request
- `404`: Unknown or excluded product or SKU
- `502`: Shopify temporarily unavailable

---

[API](https://skmtc.dev/homebridgepc/apis/halo-homebridge-agent-commerce-api.md) · [All operations](https://skmtc.dev/homebridgepc/apis/halo-homebridge-agent-commerce-api/llms.txt) · [OpenAPI document](https://skmtc.dev/homebridgepc/apis/halo-homebridge-agent-commerce-api/revisions/14766d95177c?raw)