---
title: "List product combo templates"
method: GET
path: "/templates"
tags: ["Templates"]
---

# List product combo templates

`GET /templates`

## Request

- Base URL: `https://api.pickfu.com/v1`
- URL: `https://api.pickfu.com/v1/templates`
- Auth: HTTP bearer

Lists the product combos you can create a poll from: ready-made single-question polls at a fixed price per respondent. Returns public combos plus those made for you or your team, yours first. Filter by text, access, country or option type. Call get template for one template's full constraints, audience and option slots.

## Query parameters

- `page` integer
- `limit` integer
- `query` string
- `access` 'mine' | 'public' | 'all'
- `country` 'US' | 'FR' | 'GB' | 'CH' | 'ES' | 'IT' | 'JP' | 'MX' | 'KR' | 'BR' | 'DE' | 'CA' | 'AU' | 'ZA' | 'IN' | 'PL' | 'SE' | 'GT'
- `optionType` 'text' | 'image' | 'video' | 'url' | 'product' | 'image-set' | 'audio'

## Response `200`

Default Response

- object
  - `templates` object[], required
    - `id` string, required: Template id, `cmb_<slug>`; pass it to get template
    - `name` string, required
    - `description` string, required
    - `access` 'mine' | 'public', required: `mine` when the template was made for you or your team
    - `questionTypes` string[], required
    - `optionCount` object, required
      - `min` integer, required
      - `max` integer, required
    - `pricePerResponse` number, required: Price per respondent in US dollars at the template's default country
    - `url` string, required: Opens the template in PickFu
  - `pagination` object, required
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `totalPages` integer, required
    - `hasMore` boolean, required

## Other responses

- `401`: Default Response
- `403`: Default Response

---

[API](https://skmtc.dev/pickfu/apis/pickfu-api.md) · [All operations](https://skmtc.dev/pickfu/apis/pickfu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pickfu/apis/pickfu-api/revisions/919fc58413ea?raw)
