# List organizations

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

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


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

Endpoint: GET /organizations
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 asset_count to return each organization's asset count as part of each organization'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 organizations you're fetching. Related records are returned in an included array in the response.

Allowed values: 

- brandfolders
- brandguides
- collections
- portals

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

## Response 200 fields (application/json):

  - `data` (array, required)

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

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

  - `data.attributes` (object, required)

  - `data.attributes.name` (string)
    The name of the brandfolder.
    Example: "Brandfolder's Organization"

  - `data.attributes.tagline` (string)
    The tagline of the brandfolder.
    Example: "An example tagline for the Organization"

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

  - `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