---
title: "List gallery designs"
method: GET
path: "/v2/organizations/{organizationId}/gallery"
tags: ["Template gallery"]
---

# List gallery designs

`GET /v2/organizations/{organizationId}/gallery`

## Request

- Base URL: `https://api.pdfs.build`
- URL: `https://api.pdfs.build/v2/organizations/{organizationId}/gallery`
- Auth: HTTP bearer

Every design in the pdfs.build gallery, without its source. Filter with `category` (for example `odoo`, whose designs are named after Odoo's own fields) or `useCase` (for example `odoo-invoice`). The `id` is what `POST …/templates/from-gallery` takes.

## Query parameters

- `category` string
- `useCase` string

## Response `200`

The matching designs and the per-category counts of the whole library.

- GalleryListing
  - `templates` GalleryTemplate[], required
    - `id` string, required
    - `name` string, required
    - `description` string
    - `useCase` string, required
    - `category` string, required
    - `archetype` string
    - `palette` string
    - `tier` string
    - `page` string, required
    - `pages` integer, required
  - `categories` object[], required: Every category in the library with its design count, whatever the filter.
    - `id` string, required
    - `count` integer, required

## Other responses

- `401`: Missing, invalid or expired API key.
- `403`: The organization in the URL does not match the API key's organization.
- `502`: The service that owns this resource could not be reached. Safe to retry.

---

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