---
title: "Get Brand"
method: GET
path: "/10dlc/brand/{brandId}"
tags: ["Brands"]
---

# Get Brand

`GET /10dlc/brand/{brandId}`

Retrieve a brand by `brandId`.

## Path parameters

- `brandId` string, required

## Response `200`

Successful Response

- TelnyxBrandWithCampaignsCount — Telnyx-specific extensions to The Campaign Registry's `Brand` type
  - `entityType` 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' | 'SOLE_PROPRIETOR', required — Entity type behind the brand. This is the form of business establishment.
  - `cspId` string — Unique identifier assigned to the csp by the registry.
  - `brandId` string — Unique identifier assigned to the brand.
  - `tcrBrandId` string — Unique identifier assigned to the brand by the registry.
  - `displayName` string, required — Display or marketing name of the brand.
  - `companyName` string — (Required for Non-profit/private/public) Legal company name.
  - `firstName` string — First name of business contact.
  - `lastName` string — Last name of business contact.
  - `ein` string — (Required for Non-profit) Government assigned corporate tax ID. EIN is 9-digits in U.S.
  - `phone` string — Valid phone number in e.164 international format.
  - `street` string — Street number and name.
  - `city` string — City name
  - `state` string — State. Must be 2 letters code for United States.
  - `postalCode` string — Postal codes. Use 5 digit zipcode for United States
  - `country` string, required — ISO2 2 characters country code. Example: US - United States
  - `email` string, required — Valid email address of brand support contact.
  - `stockSymbol` string — (Required for public company) stock symbol.
  - `stockExchange` 'NONE' | 'NASDAQ' | 'NYSE' | 'AMEX' | 'AMX' | 'ASX' | 'B3' | 'BME' | 'BSE' | 'FRA' | 'ICEX' | 'JPX' | 'JSE' | 'KRX' | 'LON' | 'NSE' | 'OMX' | 'SEHK' | 'SSE' | 'STO' | 'SWX' | 'SZSE' | 'TSX' | 'TWSE' | 'VSE' — (Required for public company) stock exchange.
  - `ipAddress` string — IP address of the browser requesting to create brand identity.
  - `website` string — Brand website URL.
  - `brandRelationship` 'BASIC_ACCOUNT' | 'SMALL_ACCOUNT' | 'MEDIUM_ACCOUNT' | 'LARGE_ACCOUNT' | 'KEY_ACCOUNT', required — Brand relationship to the CSP.
  - `vertical` string, required — Vertical or industry segment of the brand.
  - `altBusinessId` string — Alternate business identifier such as DUNS, LEI, or GIIN
  - `altBusinessIdType` 'NONE' | 'DUNS' | 'GIIN' | 'LEI' — An enumeration.
  - `universalEin` string — Universal EIN of Brand, Read Only.
  - `referenceId` string — Unique identifier Telnyx assigned to the brand - the brandId
  - `identityStatus` 'VERIFIED' | 'UNVERIFIED' | 'SELF_DECLARED' | 'VETTED_VERIFIED' — The verification status of an active brand
  - `optionalAttributes` BrandOptionalAttributes
    - `taxExemptStatus` string — The tax exempt status of the brand
  - `mock` boolean — Mock brand for testing purposes
  - `mobilePhone` string — Valid mobile phone number in e.164 international format.
  - `isReseller` boolean — Indicates whether this brand is known to be a reseller
  - `webhookURL` string — Webhook to which brand status updates are sent.
  - `businessContactEmail` string — Business contact email. Required if `entityType` is `PUBLIC_PROFIT`.
  - `webhookFailoverURL` string — Failover webhook to which brand status updates are sent.
  - `createdAt` string — Date and time that the brand was created at.
  - `updatedAt` string — Date and time that the brand was last updated at.
  - `status` 'OK' | 'REGISTRATION_PENDING' | 'REGISTRATION_FAILED' — Status of the brand
  - `failureReasons` string — Failure reasons for brand
  - `assignedCampaignsCount` number — Number of campaigns associated with the brand

## Other responses

- `422` — Validation Error
- `4XX` — Generic response error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)