RocketCOMS

Brand Object

The Brand object represents details for a brand.

Attributes

companyName  

string, max length: 255, min length: 0

Legal name of the business. Not required if entityType is SOLE_PROPRIETOR.

displayName  

string, max length: 255, min length: 0

Display or marketing name for the brand.

ein  

string, max length: 9, min length: 9

Employer Identification Number (EIN) assigned to the business. In the United States, an EIN contains 9 digits. Not required if entityType is SOLE_PROPRIETOR.

einIssuingCountry

string

ISO 2-letter country code for the country issuing the Employer Identification Number (EIN).

entityType

string (UUID)

Type of business for the brand. Use the List Brand Entity Types API to retrieve a list of alias values that can be used in this field.

vertical  

string

Industry segment for the brand. Not required if entityType is SOLE_PROPRIETOR. Use the List Verticals API to retrieve a list of verticalName values that can be used in this field.

website

string, max length: 100, min length: 0

pattern: ^(http:\/\/www\.|https:\/\/www\.|http:\/\/|https:\/\/)?[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,5}(:[0-9]{1,5})?(\/.*)?$

Website for the brand. Must include http:// or https://.

stockSymbol  

string, max length: 10, min length: 0

Stock symbol for the brand. Required if entityType is PUBLIC_PROFIT.

stockExchange  

string enum, values: NONE, NASDAQ, NYSE, AMEX, AMX, ASX, B3, BME, BSE, FRA, ICEX, JPX, JSE, KRX, LON, NSE, OMX, SEHK, SGX, SSE, STO, SWX, SZSE, TSX, TWSE, VSE, OTHER

Stock exchange for the brand. Required if entityType is PUBLIC_PROFIT.

firstName  

string, max length: 100, min length: 1

First name of the brand contact. Required if entityType is SOLE_PROPRIETOR.

lastName  

string, max length: 100, min length: 0

Last name of the brand contact. Required if entityType is SOLE_PROPRIETOR.

phone  

string, max length: 20, min length: 0

pattern: ^\+?[1-9]\d{1,14}$

Phone number (in E.164 format) for the brand support contact.

email  

string, max length: 100, min length: 0

Email address for the brand support contact.

street  

string, max length: 100, min length: 0

Street number and name.

city  

string, max length: 100, min length: 0

City.

state  

string, max length: 20, min length: 0

State or province. 2-character codes are required for the United States (for example, use CA for California).

postalCode  

string, max length: 10, min length: 0

Zip code or postal code. 5-digit zip codes are required for the United States.

country  

string, max length: 2, min length: 0

ISO 2-character country code. For example, use US for the United States.

id  

string (UUID)

Unique ID assigned to the brand in RocketCOMS.

businessAccountId

string

ID of the RocketCOMS Business Account that the brand belongs to.

universalEin

string

Universal Employer Identification Number (EIN) for the brand.

cspId

string

Unique ID assigned to the CSP by The Campaign Registry (TCR).

countryCode

string

ISO 2-character country code. For example, use US for the United States.

brandRelationship  

string

Brand’s history with the CSP. Not r. Use the List Brand Relationships API to retrieve a list of alias values that can be used in this field.

registrationScore

integer (int32)

Registration score assigned to the brand by The Campaign Registry (TCR) during external vetting.

createdAt

string (date-time)

Date and time the brand was created.

status

string enum, values: ACTIVE, DECLINED, DELETED, PENDING

Current status of the brand. Possible values include:

  • ACTIVE  The brand has passed the TCR Identity Verification process. Campaigns can be created for the brand.
  • DECLINED  The brand has failed the TCR Identity Verification process. Campaigns cannot be created for the brand.
  • DELETED  The brand has been deleted.
  • PENDING  The brand is currently going through the TCR Identity Verification process.

lastStatus

string (UUID)

Unique ID for the last status of the brand.

lastStatusAt

string (date-time)    

Date and time the brand status was last updated.

rejectionReason

string

Reason the brand was rejected.

Brand Object

				
					{
  "companyName": "ABC Inc.",
  "displayName": "ABC Mobile",
  "ein": "111111111",
  "einIssuingCountry": "US",
  "entityType": "PUBLIC_PROFIT",
  "vertical": "RETAIL",
  "website": "http://www.abcmobile.com",
  "stockSymbol": "ABC",
  "stockExchange": "NASDAQ",
  "firstName": "John",
  "lastName": "Doe",
  "phone": "+12024567890",
  "email": "johndoe@abc.com",
  "street": "123 6th Ave",
  "city": "New York",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "id": "d7b0e25f-30c9-456b-b287-6b3dcaa4b8f7",
  "businessAccountId": "67b25a5e-f90a-4491-9ee4-291ff290c1fe",
  "universalEin": "111111111",
  "cspId": "4e0c15a5-d798-46ff-8c50-2b30bd597abf",
  "countryCode": "US",
  "brandRelationship": "BASIC_ACCOUNT",
  "registrationScore": 0,
  "createdAt": "2022-04-20T00:18:06.347Z",
  "status": "ACTIVE",
  "lastStatus": "633eb3bb-7e78-447b-be04-e234dadfb629",
  "lastStatusAt": "2022-04-20T00:18:06.347Z",
  "rejectionReason": "string"
}