Get a brand

Get Brand by id

Get a previously created brand using its identifier.

GET/workspaces/{workspaceId}/tcr-brands/{brandId}

Authorization

useraccessKey

Path parameters

workspaceId*WorkspaceId (string (uuid))

The ID for the workspace.

Example: "d386a801-ee8d-4aba-a7e4-78671bd3b11e"

brandId*string

A unique identifier for the brand.

Response

200404

Brand

Body

application/json

idstring (uuid)

The ID of the number.

organizationIdstring (uuid)

createdAtstring (date-time)

Timestamp (UTC) when the brand was created.

updatedAtnullable string (date-time)

Timestamp (UTC) when the brand was last updated.

statusBrandStatus (enum)

Brand status

Example: "PENDING"

FAILEDPENDINGREJECTEDAPPROVEDDELETEDDRAFT

entityType*BrandEntityType (enum)

Legal entity type. It can't be updated when the brand is approved.

Example: "PRIVATE_PROFIT"

PRIVATE_PROFITPUBLIC_PROFITNON_PROFITGOVERNMENT

firstNamestring

First or given name. Applicable to entity type.

Example: "John"

lastNamestring

Last or Surname. Applicable to entity type.

Example: "Doe"

displayName*string

Display or marketing name your brand.

Example: "ABC Mobile"

companyName*string

Legal company name. This should match the legal company name used to register your EIN/Tax ID.

Example: "ABC Inc."

ein*string

Government assigned corporate tax ID. EIN is 9-digits in the U.S.

Example: "111111111"

einIssuingCountry*string

The 2 letter ISO country of registration submitted with your EIN / Tax ID registration.

Example: "US"

phone*string

Valid phone number in e.164 international format.

Example: "[phone]"

street*string

Street number and name.

Example: "123 6th Ave"

city*string

City name

Example: "New York"

state*string

State. Must be a 2 letter state code for US states.

Example: "NY"

postalCode*string

Postal code. Must be a 5 digit zip code for the United States.

Example: "10001"

country*string

ISO 2 character country code.

Example: "US"

email*string

Valid email address of brand support contact.

Example: "[e-mail]"

stockSymbolstring

Stock symbol.

Example: "ABC"

stockExchangeBrandStockExchange (enum)

Stock exchange. Required for entityType PUBLIC.

Example: "NASDAQ"

NONENASDAQNYSEAMEXAMXASXB3BMEBSEFRAICEXJPXJSEKRXLONNSEOMXSEHKSGXSSESTOSWXSZSETSXTWSEVSEOTHER

website*string

Brand website URL.

Example: "https://example.com"

verticalstring

Vertical or industry segment of the brand.

Example: "RETAIL"

altBusinessIdstring

Alternate business identifier.

altBusinessIdTypeBrandAltBusinessIdType (enum)

Alternate business identifier type. Required if altBusinessId is provided.

NONEDUNSGIINLEI

businessContactEmailone of

Business contact email.

string (email)string

businessContactEmailVerifiedDatestring (date-time)

Timestamp (UTC) when the brand businessContactEmail was verified.

workspaceIdsnullable array of string (uuid)

Workspace IDs with access to the brand.

rejectionobject

Rejection details

Request

JavaScriptCurlPython

const response = await fetch('/workspaces/{workspaceId}/tcr-brands/{brandId}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer jwt"
    },
});
const data = await response.json();

Response

200404

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-01-21T01:21:27.797Z",
  "updatedAt": "2025-01-21T01:21:27.797Z",
  "status": "PENDING",
  "entityType": "PRIVATE_PROFIT",
  "firstName": "John",
  "lastName": "Doe",
  "displayName": "ABC Mobile",
  "companyName": "ABC Inc.",
  "ein": "111111111",
  "einIssuingCountry": "US",
  "phone": "[phone]",
  "street": "123 6th Ave",
  "city": "New York",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "[e-mail]",
  "stockSymbol": "ABC",
  "stockExchange": "NASDAQ",
  "website": "https://example.com",
  "vertical": "RETAIL",
  "altBusinessId": "text",
  "altBusinessIdType": "NONE",
  "businessContactEmail": "[e-mail]",
  "businessContactEmailVerifiedDate": "2025-01-21T01:21:27.797Z",
  "workspaceIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "rejection": {
    "description": "text",
    "code": "text"
  }
}

Type	Description
BrandReponse	BrandResponse object describes a submitted brand