---
title: "List Brands"
method: GET
path: "/management/v1/projects/{projectId}/branding"
tags: ["Management"]
---

# List Brands

`GET /management/v1/projects/{projectId}/branding`

Lists all brand configurations.

Because a project can have only one brand, it always returns a list with one item.

This endpoint can be used to retrieve the brand configuration created with the Voucherify Dashboard and the ID.

## Response `200`

Returns the details about the brand created in the project.

- ManagementProjectsBrandingListResponseBody — Object containing a list of brand configurations. It always contains one item.
  - `object` 'list', required — The type of the object represented by JSON. This object stores information about the brand in a dictionary.
  - `data_ref` 'data', required — Identifies the name of the attribute that contains the array of brand objects.
  - `data` ManagementProjectsBranding[], required — Array of brand objects. It contains only one object.
    - `id` string, required — Unique identifier of the brand configuration.
    - `brand` object, required — Defines basic brand details.
      - `name` string, required — Defines brand name.
      - `privacy_policy_url` string, nullable, required — Defines the URL to the brand's privacy policy. It must be a valid URL format.
      - `terms_of_use_url` string, nullable, required — Defines the URL to the brand's terms of use. It must be a valid URL format.
      - `permission_reminder` string, required — Defines the message that is displayed to customers who opted in an email newsletter.
      - `website_url` string, nullable, required — Defines the URL to the brand's website. It must be a valid URL format.
    - `address` object, required — Defines the address details.
      - `street` string, required — Defines the brand's street.
      - `city` string, required — Defines the brand's city.
      - `postal` string, nullable, required — Defines the brand's postal code.
      - `state` string, required — Defines the brand's state or similar administrative area.
      - `country` string, required — Defines the brand's country.
    - `contact` object, required — Defines contact details.
      - `email` string, required — Defines the brand's email address. It must be a valid email format.
      - `phone` string, nullable, required — Defines the brand's phone number.
  - `total` integer, required — The total number of brand objects. It is always `1`.

## Other responses

- `401` — Returns an error if an invalid token was provided.
- `402` — Returns an error if the current plan does not include the Management API feature.
- `404` — Returns an error when a resource could not be found.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/revisions/4982266e0494/schema)