---
title: "List playbooks"
method: GET
path: "/playbooks"
tags: ["Playbooks"]
---

# List playbooks

`GET /playbooks`

## Request

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

Returns a paginated list of available PickFu playbooks (step-by-step research guides). Each playbook is a structured sequence of polls designed for a specific research goal. Optionally filter by industry.

## Query parameters

- `page` integer
- `limit` integer
- `industry` string

## Response `200`

Default Response

- object
  - `playbooks` object[]
    - `slug` string, nullable: Unique playbook identifier (GUID)
    - `name` string: Playbook name
    - `description` string, nullable: Short description of the playbook
    - `industry` string, nullable: Industry category
    - `poll_count` integer: Number of surveys in this playbook
    - `duration` string, nullable: Estimated completion time (e.g. "2-3 days")
    - `icon` string, nullable: Icon identifier or emoji
    - `icon_lucide` string, nullable: Lucide icon name for the UI
    - `url` string, nullable: Direct URL to view this playbook on PickFu. Always null — no /playbooks/<slug> route exists
  - `pagination` object
    - `total` integer: Total number of matching playbooks
    - `page` integer: Current page number
    - `limit` integer: Number of playbooks per page
    - `totalPages` integer: Total number of pages

## Other responses

- `500`: 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)