---
title: "Get playbook"
method: GET
path: "/playbooks/{slug}"
tags: ["Playbooks"]
---

# Get playbook

`GET /playbooks/{slug}`

## Request

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

Retrieves a playbook by its slug. Returns the full structured playbook including goal, step-by-step instructions with poll creation URLs, and metadata. The steps_markdown field contains formatted instructions with embedded poll creation links.

## Path parameters

- `slug` string, required

## Response `200`

Default Response

- 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
  - `goal` string, nullable: The research goal this playbook helps achieve
  - `steps_markdown` string, nullable: Formatted instructions with embedded survey creation links
  - `project_name_template` string, nullable: Template for the project name when starting this playbook

## Other responses

- `404`: Default Response
- `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)