---
title: "Product details, placements and variants"
method: GET
path: "/v1/products/{product_id}"
---

# Product details, placements and variants

`GET /v1/products/{product_id}`

## Request

- Base URL: `https://pod.agentmade.dev`
- URL: `https://pod.agentmade.dev/v1/products/{product_id}`
- Auth: none declared

## Path parameters

- `product_id` string, required

## Response `200`

Product

- Product
  - `product_id` string, required: Use in get_product, validate_artwork and quote.
  - `title` string, required
  - `image_url` string, nullable, required: A product photo, or null when none is approved yet.
  - `brand` string, nullable, required
  - `model` string, required
  - `category` string, required
  - `description` string, required
  - `decoration_method` string, required
  - `colors` object[], required
    - `id` string, required
    - `name` string, required
    - `hex` string, required
    - `printed_in_regions` string[], required: Regions where this product is printed, e.g. ["EU", "US"].
    - `images` object[], required
      - `url` string, required
      - `view` string, required
      - `style` string, required
      - `alt` string, required
      - `ai_generated` boolean, required: True for an AI-made photo. Say so when you show it.
  - `sizes` string[], required: Size values to pass as size.
  - `placements` object[], required
    - `id` string, required
    - `name` string, required
    - `print_area_mm` object, required
      - `width` number, required
      - `height` number, required
    - `safe_margin_mm` number, required
    - `default_preset` string, required
    - `presets` object[], required
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `max_width_mm` number, required
      - `max_height_mm` number, nullable
      - `top_mm` number, required
  - `printed_in_regions` string[], required: Regions where this product is printed, e.g. ["EU", "US"].
  - `production_business_days` object, required
    - `min` number, nullable, required
    - `max` number, nullable, required
  - `size_chart_cm` object[], nullable, required
    - `name` string, required
  - `variants` object[], required
    - `variant_id` string, required
    - `color` string, required
    - `size` string, required
  - `artwork_guidance` string, required
  - `next_step` string, required: What the agent should do next, in plain language.

## Other responses

- `4XX`: Error with a machine-readable code and a hint for the next step
- `5XX`: Error with a machine-readable code and a hint for the next step

---

[API](https://skmtc.dev/agentmade/apis/agentmade-print-on-demand-api.md) · [All operations](https://skmtc.dev/agentmade/apis/agentmade-print-on-demand-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentmade/apis/agentmade-print-on-demand-api/revisions/542fad1de43b?raw)