---
title: "Returns a list of brands for the current user."
method: GET
path: "/v2/settings/brands"
tags: ["Brands Api Service"]
---

# Returns a list of brands for the current user.

`GET /v2/settings/brands`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/settings/brands`
- Auth: none declared

## Response `200`

OK

- JsonOkListResponseBrandLite
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` BrandLite[]
    - `id` integer
    - `userId` integer
    - `ownerUserId` integer
    - `label` string
    - `title` string
    - `description` string
    - `image` string
    - `ownerUsername` string
    - `hash` string
    - `joinDate` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `firstConnectionDate` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `timezone` string
    - `brandRole` BrandRole
      - `id` integer
      - `userId` integer, required
      - `name` string, required
      - `description` string
      - `color` string
      - `type` string
      - `assignable` boolean
      - `teamMemberOnly` boolean
      - `deletedDate` DateTimeInfo
        - `dateTime` string, required: Local Date-time represented with a certain timezone
        - `timezone` string: Timezone applied to the datetime
      - `deleted` boolean
      - `actions` BrandRoleActions, required
        - `viewAnalytics` boolean
        - `viewInbox` boolean
        - `viewPlanner` boolean
        - `viewAds` boolean
        - `viewSmartlinks` boolean
        - `fullAccessReports` boolean
        - `fullAccessInbox` boolean
        - `fullAccessPlanner` boolean
        - `fullAccessAds` boolean
        - `fullAccessSmartlinks` boolean
        - `fullAccessHashtagTracker` boolean
        - `editBrand` boolean
        - `schedulePosts` boolean
        - `publishPosts` boolean
        - `approvePosts` boolean
        - `viewCondensedAnalytics` boolean
        - `fullAccessDashboards` boolean
        - `viewDashboards` boolean
        - `editFlow` boolean
        - `viewFlow` boolean
        - `fullAccessStudio` boolean
      - `organizationActions` OrganizationRoleActionsDto, required: Organization-level permissions granted by a brand role, on top of the per-brand actions. Never null in a read response - a role that never had organization permissions set is reported with every field false.
        - `manageBrands` boolean: Whether the role can create and manage brands at the organization level.
        - `manageRoles` boolean: Whether the role can create and manage other brand roles at the organization level.
        - `manageTeamMembers` boolean: Whether the role can manage team members at the organization level.
        - `manageAgencyConfig` boolean: Whether the role can manage the agency configuration.
        - `manageAgencyClients` boolean: Whether the role can manage agency clients.
      - `assignedUsersCount` integer
      - `assignedEnabledCount` integer
      - `assignedDisabledCount` integer
    - `engagementRatio` integer
    - `networksData` NetworksData
      - `webData` string
      - `facebookData` string
      - `instagramData` string
      - `threadsData` string
      - `blueskyData` string
      - `twitterData` string
      - `linkedinData` string
      - `pinterestData` string
      - `tiktokData` string
      - `gbpData` string
      - `youtubeData` string
      - `twitchData` string
      - `facebookAdsData` string
      - `googleAdsData` string
      - `tiktokAdsData` string
    - `isShared` boolean

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)