# List 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}

Endpoint: GET /brandfolders
Version: v4
Security: APIToken

## Header parameters:

  - `Content-Type` (string, required)
    Enum: "application/json"

  - `Accept` (string, required)
    Enum: "application/json"

  - `Authorization` (string, required)
    Bearer token for authentication

## Query parameters:

  - `fields` (string)
    Set it to a comma-separated list (no spaces) of any of the following attributes of the Brandfolders
to return as part of the Brandfolders' attributes in the response.

Allowed values: 

- asset_count
- attachment_count
- storage

WARNING: This parameter can slow response times.
    Example: "asset_count,attachment_count,storage"

  - `include` (string)
    Set it to a comma-separated list (no spaces) of any of the following record names to return those records related to the Brandfolders you're fetching. Related records are returned in an included array in the response.

Allowed values: 

- organization
- collections
- assets

WARNING: This parameter can slow response times.
    Example: "organizations"

  - `search` (string)
    Set it to any URL-encoded query to fetch only Brandfolders that match your criteria.

WARNING: This parameter can slow response times.
    Example: "extension:png"

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.id` (string, required)
    Unique identifier for the resource instance.
    Example: "oqgiju-21olts-ce9egi"

  - `data.type` (string, required)
    The type of the resource.
    Enum: "brandfolders"

  - `data.attributes` (object, required)

  - `data.attributes.name` (string, required)
    The name of the brandfolder.
    Example: "Brandfolder"

  - `data.attributes.privacy` (string, required)
    The privacy setting of the brandfolder.
    Example: "private"

  - `data.attributes.slug` (string, required)
    The URL-friendly slug of the brandfolder.
    Example: "brandfolder"

  - `data.attributes.tagline` (string, required)
    The tagline of the brandfolder.
    Example: "You expected this - Brandfolder's Brandfolder!"

  - `meta` (object, required)
    Page context information.

  - `meta.current_page` (integer, required)
    Example: 1

  - `meta.next_page` (object,null, required)

  - `meta.prev_page` (object,null, required)

  - `meta.total_pages` (number, required)
    Example: 1

  - `meta.total_count` (number, required)
    Example: 1