# Fetch a Brandfolder

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


https://brandfolder.com/{slug}

Endpoint: GET /brandfolders/{brandfolder_id}
Version: v4
Security: APIToken

## Path parameters:

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

## 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 Brandfolder
to return as part of the Brandfolder's attributes in the response.

Allowed values: 

- asset_count
- attachment_count
- section_count

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

  - `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 Brandfolder you're fetching. Related records are returned in an included array in the response.

Allowed values: 

- organization
- collections
- search_filters
- sections

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

## Response 200 fields (application/json):

  - `data` (object, 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!"