Skip to main content
Permission: Read · Workspace: not required (global) Fetches full detail for a single product — richer than a search result. Use it when the user is close to committing and you need the description, shipping tier, alcohol status, or US state restrictions.

Parameters

product_id
string
required
Product UUID, from a goody_products_search result.

Returns

id
string
Product UUID.
name
string
Product name.
brand
string | null
Brand name.
image_key
string | null
Opaque image key for the product photo.
price_cents
integer | null
Price in cents for fixed-price products.
description
string | null
Full product description.
additional_images
string[]
Extra image keys beyond the primary photo.
shipping_tier
string
domestic_us, international, or any.
alcohol
boolean
True if the product contains alcohol (extra requirements apply to send).
restrictions
string[]
US state codes where this product can’t ship.
price_type
string | null
fixed, variable, or tiers.
is_flex_gift
boolean
True for a Gift of Choice (recipient picks; sender funds an amount).
price_min
integer | null
Lowest amount (cents) the sender may fund, for a Gift of Choice.
price_max
integer | null
Highest fundable amount; null means unlimited.
Returns a not-found error if the product id is unknown, private, or inactive.

Example

"Tell me more about the Cold Brew Starter Kit."
{
  "name": "goody_products_get",
  "arguments": { "product_id": "0f3c…" }
}
{
  "id": "0f3c…",
  "name": "Cold Brew Starter Kit",
  "brand": "Grady's",
  "image_key": "products/cold-brew-starter-kit.png",
  "price_cents": 4200,
  "description": "Everything to brew smooth cold brew at home: a glass carafe, a reusable filter, and two pouches of coarse-ground beans.",
  "additional_images": [
    "products/cold-brew-starter-kit-2.png",
    "products/cold-brew-starter-kit-3.png"
  ],
  "shipping_tier": "domestic_us",
  "alcohol": false,
  "restrictions": [],
  "price_type": "fixed",
  "is_flex_gift": false,
  "price_min": null,
  "price_max": null
}
Pair with goody_products_search to discover products, or goody_gift_of_choice_list when the recipient’s taste is unknown.