---
title: "Read one exact configuration through its published path"
method: GET
path: "/v1/configurations/fire-pits/{body}/{tabletop}/{fuel}/{shape}"
---

# Read one exact configuration through its published path

`GET /v1/configurations/fire-pits/{body}/{tabletop}/{fuel}/{shape}`

## Request

- Base URL: `https://agent-commerce.homebridgepc.com`
- URL: `https://agent-commerce.homebridgepc.com/v1/configurations/fire-pits/{body}/{tabletop}/{fuel}/{shape}`
- Auth: none required

Delegates to the existing deterministic live Shopify resolver. A currently unavailable variant remains HTTP 200 with availability unavailable and null cart links. A removed configuration is 404. An unavailable commerce authority returns 502, with no historical price or cart asserted. Read-only: no order, payment or checkout-session creation.

## Path parameters

- `body` 'brickyard' | 'stackstone' | 'limestone' | 'corten-steel', required
- `tabletop` 'polished-limestone' | 'polished-black-granite', required
- `fuel` 'natural-gas' | 'propane' | 'wood-burning', required
- `shape` 'square' | 'round', required

## Response `200`

Exact current configuration, including unavailable configurations with null cart action

- object
  - `configuration` object, required
    - `bodyStyle` 'Brickyard' | 'Stackstone' | 'Limestone' | 'Corten Steel', required
    - `tabletopFinish` 'GFRC Polished Limestone Finish' | 'GFRC Polished Black Granite Finish', required
    - `fuelType` 'Natural Gas' | 'Propane' | 'Wood Burning', required
    - `shape` 'Square' | 'Round', required
  - `configurationUrl` string, uri, required
  - `sku` string, required
  - `variantId` string, required
  - `product` string, required
  - `productHandle` string, required
  - `configurationIndexUrl` string, uri
  - `availability` 'available' | 'unavailable', required
  - `price` object, required
    - `amount` string, required
    - `currency` 'USD', required
    - `authority` 'live_shopify', required
  - `primaryMedia` object, nullable, required: Existing Shopify media projection with relationship and fidelity disclosures; null if no media exists.
  - `media` object, required: Existing HALO product media projection, without binary downloads.
  - `commerceLinks` object, required
    - `evidenceUrl` string, uri, nullable, required
    - `customerUrl` string, uri, required
    - `cartUrl` string, uri, nullable, required
    - `checkoutUrl` unknown, required
    - `exactVariantProductUrl` string, uri
    - `shopifyCartPermalink` string, uri, nullable
  - `requiredDisclosures` string[], required
  - `boundaries` object, required
    - `mayPlaceOrder` unknown
    - `mayCollectPayment` unknown
    - `shopifyRemainsAuthoritative` unknown
  - `commerceAuthority` 'live_shopify', required
  - `commerceCheckedAt` string, date-time, required

## Other responses

- `404`: Invalid path value or configuration absent from current Shopify catalog
- `405`: Read-only endpoint; mutations are not supported
- `500`: Unexpected failure; no commerce assertion
- `502`: Shopify unavailable or ambiguous catalog; no current price or cart asserted

---

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