---
title: "Search printable products"
method: GET
path: "/v1/products"
---

# Search printable products

`GET /v1/products`

## Request

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

## Query parameters

- `q` string
- `category` string
- `color` string
- `size` string

## Response `200`

Matching products

- SearchProductsResult
  - `products` object[], required
    - `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` string[], required: Colour ids to pass as color.
    - `sizes` string[], required: Size values to pass as size.
    - `placements` string[], required: Placement ids to pass as placement.
    - `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
  - `count` integer, required
  - `note` string, required

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