---
title: "Get all brands"
method: GET
path: "/v2/brands"
---

# Get all brands

`GET /v2/brands`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/brands`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/brands/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to retrieve all brands associated with their account.

**Notes**

Each brand has an `owner_type` field that defines who owns it and what access is allowed. There are three ownership types:

* **`common`** — system default SignNow brand. Read-only; cannot be edited or customized. Appears in the brand list, but any modification attempt returns a "No access to brand" error.
* **`organization`** — custom brand owned by the organization. Full access for organization admins. This is the brand type customers should create and use.
* **`user`** — custom brand owned by an individual user.

## Response `200`

Successful response. Returns the brands available to the user. The SignNow default brand (`owner_type`: `common`) is always included.

- object
  - `data` object[]: List of brands.
    - `link` string: Link to retrieve the brand.
    - `title` string: Brand name.
    - `resources` object: Brand resources. Empty array `[]` if no resources are configured. Object with resource type keys (`general`, `editor`, `email`, `logo`, `send-invite`, etc.) if resources exist. An empty array if the brand has no resources.
      - `logo` object: Logo resource of the brand. Returned only if the resource is set.
        - `data` string: Content of the resource. `null` in the list; get the resource by `link` to see its content.
        - `link` string: URL to get the logo resource.
      - `email` object: Email resource of the brand. Returned only if the resource is set.
        - `data` string: Content of the resource. `null` in the list; get the resource by `link` to see its content.
        - `link` string: URL to get the email resource.
      - `editor` object: Editor resource of the brand. Returned only if the resource is set.
        - `data` string: Content of the resource. `null` in the list; get the resource by `link` to see its content.
        - `link` string: URL to get the editor resource.
      - `general` object: General resource of the brand. Returned only if the resource is set.
        - `data` string: Content of the resource. `null` in the list; get the resource by `link` to see its content.
        - `link` string: URL to get the general resource.
      - `sms-invite` object: SMS invite resource of the brand. Returned only if the resource is set.
        - `data` string: Content of the resource. `null` in the list; get the resource by `link` to see its content.
        - `link` string: URL to get the sMS invite resource.
      - `email-invite` object: Email invite resource of the brand. Returned only if the resource is set.
        - `data` string: Content of the resource. `null` in the list; get the resource by `link` to see its content.
        - `link` string: URL to get the email invite resource.
      - `email-general` object: Email general resource of the brand. Returned only if the resource is set.
        - `data` string: Content of the resource. `null` in the list; get the resource by `link` to see its content.
        - `link` string: URL to get the email general resource.
      - `email-invite-approver` object: Email invite resource for approvers of the brand. Returned only if the resource is set.
        - `data` string: Content of the resource. `null` in the list; get the resource by `link` to see its content.
        - `link` string: URL to get the email invite resource for approvers.
    - `unique_id` string: Brand unique ID.
    - `owner_type` string: Brand owner type. Allowed values: `common`, `organization`, `user`.
  - `meta` object: Pagination metadata.
    - `pagination` object: Pagination details.
      - `count` integer: Number of brands on the current page.
      - `links` object: Links to the adjacent pages. An empty array if there are no other pages.
        - `next` string: URL of the next page. Returned only if there is a next page.
        - `previous` string: URL of the previous page. Returned only if there is a previous page.
      - `total` integer: Total number of brands.
      - `per_page` integer: Number of items per page.
      - `total_pages` integer: Total number of pages.
      - `current_page` integer: Current page number.

## Other responses

- `400`: * Wrong, expired, or missing token. * Deactivated or deleted application.
- `403`: The user is authorized with a token from an app they don’t own.

---

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