---
title: "List Brandfolders"
method: GET
path: "/brandfolders"
tags: ["brandfolders"]
---

# List Brandfolders

`GET /brandfolders`

Lists all Brandfolders for a User. Unauthorized requests will return an
empty list.

You can use the returned `slug` attribute to form a link to the desired
Brandfolder like so:

````
https://brandfolder.com/{slug}
````

## Query parameters

- `fields` string
- `include` string
- `search` string

## Response `200`

References to all the user's Brandfolders.

- object
  - `data` Brandfolder[], required
    - `id` string, required — Unique identifier for the resource instance.
    - `type` 'brandfolders', required — The type of the resource.
    - `attributes` BrandfolderAttributes, required
      - `name` string, required — The name of the brandfolder.
      - `privacy` string, required — The privacy setting of the brandfolder.
      - `slug` string, required — The URL-friendly slug of the brandfolder.
      - `tagline` string, required — The tagline of the brandfolder.
  - `meta` PaginationMetadataResponse, required — Page context information.
    - `current_page` integer, required
    - `next_page` object, nullable, required
    - `prev_page` object, nullable, required
    - `total_pages` unknown, required
    - `total_count` unknown, required

## Other responses

- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/brandfolder-openapi-reference/revisions/fd95b0a2d2f8/schema)