# Fetch a collection

Returns the matching collection.

Endpoint: GET /collections/{collection_id}
Version: v4
Security: APIToken

## Path parameters:

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

## Header parameters:

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

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

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

## Query parameters:

  - `fields` (string)
    Set it to asset_count to return the collection's asset count as part
of the collection's attributes in the response.


WARNING: This parameter can slow response times.
    Enum: "asset_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 collection you're
fetching. Related records are returned in an included array in the
response.

Allowed values: 

- brandfolder
- assets
- search_filters

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

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.id` (string, required)
    Unique identifier for the resource instance.
    Example: "oqgkkd-fr5iv4-hh142d"

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

  - `data.attributes` (object, required)

  - `data.attributes.name` (string)
    The name of the collection.
    Example: "My collection"

  - `data.attributes.tagline` (string)
    The tagline of the collection.
    Example: "My collection tag line"

  - `data.attributes.slug` (string)
    The URL-friendly slug of the collection.
    Example: "my-collection"

  - `data.attributes.public` (boolean)
    Set to true for hassle-free sharing, allowing search engines to index your brand assets. Otherwise, set to false to share only with the users you specify.

  - `data.attributes.stealth` (boolean)
    Set to true to remove the collection from appearing in web searches.

  - `data.attributes.is_workspace` (boolean)
    Set to true if the collection is a Brandfolder workspace.