---
title: "Browse the slide-template catalog (patterns + segment showcase)"
method: GET
path: "/v1/catalog"
tags: ["catalog"]
---

# Browse the slide-template catalog (patterns + segment showcase)

`GET /v1/catalog`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/catalog`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

The public gallery + agent catalog. Returns slide templates with segment/use-case/family facets. Filter with `?segment=`, `?use_case=`, `?family=`, `?layer=pattern|showcase`, and free-text `?q=`. No auth. Layer `pattern` = structural variants; `showcase` = authored segment-specific example slides.

## Query parameters

- `segment` string, nullable
- `use_case` string, nullable
- `family` string, nullable
- `layer` string, nullable: pattern | showcase
- `q` string, nullable: free-text over title + blurb

## Response `200`

Successful Response

- CatalogResponse
  - `items` CatalogItem[], required
    - `slug` string, required
    - `layer` string, required
    - `title` string, required
    - `family` string, required
    - `family_label` string, required
    - `variant` string, nullable
    - `variant_label` string, nullable
    - `segments` string[], required
    - `use_cases` string[], required
    - `blurb` string, required
    - `preview_url` string, required
    - `render_ready` boolean
  - `count` integer, required
  - `segments` Facet[], required
    - `id` string, required
    - `label` string, required
    - `count` integer, required
  - `use_cases` Facet[], required
    - `id` string, required
    - `label` string, required
    - `count` integer, required
  - `families` Facet[], required
    - `id` string, required
    - `label` string, required
    - `count` integer, required

## Other responses

- `422`: Validation Error

---

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