---
updatedAt: 2026-08-25T22:51:55.000Z
agentTools:
  projectIndex: https://docs.wistia.com/llms.txt
---

# Show Brand

Returns the brand with the given id.

## Requires api token with one of the following permissions
```
Read all data
```

Tokens with the "Act with a team member's permissions" permission
(`all:delegate_to_contact_permissions` scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An [expiring access token](https://docs.wistia.com/reference/post_expiring-token)
created with the `all:delegate_to_contact_permissions` scope and an
authorization naming this brand (any permission) can also be used.


# OpenAPI definition

````json
{
  "openapi": "3.1.1",
  "info": {
    "title": "Data API",
    "description": "Wistia Data API",
    "version": "2026.09.0"
  },
  "servers": [
    {
      "url": "https://api.wistia.com/modern"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Brands"
    }
  ],
  "paths": {
    "/brands/{brandId}": {
      "get": {
        "summary": "Show Brand",
        "x-speakeasy-group": "brands",
        "x-speakeasy-name-override": "get",
        "description": "Returns the brand with the given id.\n\n## Requires api token with one of the following permissions\n```\nRead all data\n```\n\nTokens with the \"Act with a team member's permissions\" permission\n(`all:delegate_to_contact_permissions` scope) can also be used. Requests\nmade with such a token are authorized using the permissions of the\ncontact assigned to the token.\n\nAn [expiring access token](https://docs.wistia.com/reference/post_expiring-token)\ncreated with the `all:delegate_to_contact_permissions` scope and an\nauthorization naming this brand (any permission) can also be used.\n",
        "parameters": [
          {
            "name": "brandId",
            "in": "path",
            "description": "The id of the brand.",
            "required": true,
            "schema": {
              "description": "Id of the brand (e.g., \"abcde12345\")",
              "type": "string"
            }
          },
          {
            "name": "X-Wistia-API-Version",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "2026-09"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Brand retrieval successful",
            "content": {
              "application/json": {
                "schema": {
                  "unevaluatedProperties": false,
                  "type": "object",
                  "description": "A brand is a saved set of branding options — colors, fonts, logos, and\nlayout — that can be applied to media, folders, and channels.\n",
                  "properties": {
                    "id": {
                      "description": "A unique alphanumeric identifier for this brand.",
                      "type": "string",
                      "examples": [
                        "abcde12345"
                      ]
                    },
                    "name": {
                      "description": "The brand's display name.",
                      "type": "string",
                      "examples": [
                        "My Brand"
                      ]
                    },
                    "is_default": {
                      "description": "Whether this brand is the account-level default, applied to content that has no more specific brand.",
                      "type": "boolean",
                      "examples": [
                        true
                      ]
                    },
                    "created": {
                      "description": "The date the brand was originally created.",
                      "type": "string",
                      "format": "date-time",
                      "examples": [
                        "2010-08-13T18:47:39+00:00"
                      ]
                    },
                    "updated": {
                      "description": "The date the brand was last updated.",
                      "type": "string",
                      "format": "date-time",
                      "examples": [
                        "2010-08-19T21:47:00+00:00"
                      ]
                    },
                    "primary_color": {
                      "description": "The primary brand color, used for primary buttons and the player playbar. Either a hex color string or a gradient represented as an array of [hexColor, percentage] tuples. Null when unset.",
                      "unevaluatedProperties": false,
                      "oneOf": [
                        {
                          "type": "string",
                          "examples": [
                            "#2949E5"
                          ]
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "items": {}
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "page_background_color": {
                      "description": "The brand color used for page backgrounds. Either a hex color string or a gradient represented as an array of [hexColor, percentage] tuples. Null when unset.",
                      "unevaluatedProperties": false,
                      "oneOf": [
                        {
                          "type": "string",
                          "examples": [
                            "#2949E5"
                          ]
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "items": {}
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "body_font_family": {
                      "description": "The brand font family for body text. Null when unset.",
                      "type": [
                        "string",
                        "null"
                      ],
                      "examples": [
                        "Inter"
                      ]
                    },
                    "headline_font_family": {
                      "description": "The brand font family for headlines. Null when unset.",
                      "type": [
                        "string",
                        "null"
                      ],
                      "examples": [
                        "GT Walsheim"
                      ]
                    },
                    "button_font_family": {
                      "description": "The brand font family for buttons. Null when unset.",
                      "type": [
                        "string",
                        "null"
                      ],
                      "examples": [
                        "Inter"
                      ]
                    },
                    "border_radius": {
                      "description": "The border radius in pixels for rounded corners. Null when unset.",
                      "type": [
                        "integer",
                        "null"
                      ],
                      "examples": [
                        10
                      ]
                    },
                    "contrast_icons": {
                      "description": "Controls whether the player icon color is always white or uses an accessible contrast color when necessary.",
                      "type": [
                        "string",
                        "null"
                      ],
                      "enum": [
                        "enabled",
                        "disabled",
                        "unset",
                        null
                      ]
                    },
                    "opaque_controls": {
                      "description": "Controls the opacity of the video player control bar and big play button.",
                      "type": [
                        "string",
                        "null"
                      ],
                      "enum": [
                        "enabled",
                        "disabled",
                        "unset",
                        null
                      ]
                    },
                    "page_logo": {
                      "description": "The brand logo used for pages. Null when unset.",
                      "type": [
                        "object",
                        "null"
                      ],
                      "unevaluatedProperties": false,
                      "properties": {
                        "url": {
                          "description": "The Wistia delivery URL of the logo image, e.g. `https://embed-ssl.wistia.com/deliveries/abc123def456.png`. When writing, this must reference an image already in the account; the API cannot upload one.",
                          "type": "string"
                        },
                        "dimensions": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "unevaluatedProperties": false,
                          "properties": {
                            "width": {
                              "type": "integer"
                            },
                            "height": {
                              "type": "integer"
                            }
                          }
                        },
                        "size": {
                          "description": "The size multiplier of the logo.",
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "player_logo": {
                      "description": "The brand logo used for the player. Null when unset.",
                      "type": [
                        "object",
                        "null"
                      ],
                      "unevaluatedProperties": false,
                      "properties": {
                        "url": {
                          "description": "The Wistia delivery URL of the logo image, e.g. `https://embed-ssl.wistia.com/deliveries/abc123def456.png`. When writing, this must reference an image already in the account; the API cannot upload one.",
                          "type": "string"
                        },
                        "dimensions": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "unevaluatedProperties": false,
                          "properties": {
                            "width": {
                              "type": "integer"
                            },
                            "height": {
                              "type": "integer"
                            }
                          }
                        },
                        "size": {
                          "description": "The size multiplier of the logo.",
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "cursor": {
                      "description": "A cursor for stable pagination based on current `sort_by` order. You can pass this to `cursor[before]` or `cursor[after]` as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with `cursor[enabled]`, or `cursor[before]` or `cursor[after]`.",
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized, invalid or missing token",
            "content": {
              "application/json": {
                "schema": {
                  "unevaluatedProperties": false,
                  "type": "object",
                  "properties": {
                    "code": {
                      "description": "A machine-readable identifier for the specific authorization failure.",
                      "type": "string",
                      "enum": [
                        "unauthorized_credentials",
                        "account_inactive",
                        "unauthorized_scope",
                        "unauthorized_params"
                      ]
                    },
                    "error": {
                      "type": "string",
                      "examples": [
                        "Invalid credentials."
                      ]
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "unevaluatedProperties": false,
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "examples": [
                        "Folder with ID 'fakeid' not found."
                      ]
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "unevaluatedProperties": false,
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "examples": [
                        "Internal server error"
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Brands"
        ],
        "x-readme": {
          "code-samples": [
            {
              "name": "Typescript (SDK)",
              "language": "javascript",
              "code": "import { Wistia } from \"@wistia/wistia-api-client\";\n\nconst wistia = new Wistia({\n  bearerAuth: process.env[\"WISTIA_BEARER_AUTH\"] ?? \"\",\n});\n\nasync function run() {\n  const result = await wistia.brands.get({\n    brandId: \"<id>\",\n  });\n\n  console.log(result);\n}\n\nrun();"
            }
          ]
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "x-readme": {
    "samples-languages": [
      "javascript",
      "shell",
      "node",
      "python",
      "ruby"
    ]
  }
}
````