Sign in

v50

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-06-16122182589.7 KB
10DLC

Register a 10DLC Brand

Registers a 10DLC Brand. TCR automatically verifies the brand identity. Only brands with VERIFIED or VETTED_VERIFIED identity status can register 10DLC Campaigns.

post/v3/10dlc/brands

Request body

dba_namestring required

Brand name or DBA

company_namestring required

Legal name of the company

entity_type'PUBLIC_PROFIT' required

Legal entity type of the company. One of PRIVATE_PROFIT (privately held for-profit company), PUBLIC_PROFIT (publicly traded for-profit company), NON_PROFIT (non-profit organization), or GOVERNMENT (government entity).

vertical'HEALTHCARE' | 'PROFESSIONAL' | 'RETAIL' | 'TECHNOLOGY' | 'EDUCATION' | 'FINANCIAL' | 'NON_PROFIT' | 'GOVERNMENT' | 'OTHER' required

Business segment the Brand operates in. One of:

  • HEALTHCARE — healthcare.
  • PROFESSIONAL — professional services.
  • RETAIL — retail.
  • TECHNOLOGY — technology.
  • EDUCATION — education.
  • FINANCIAL — financial services.
  • NON_PROFIT — non-profit organizations.
  • GOVERNMENT — government entities.
  • OTHER — any segment not listed above.
ein_taxidstring required

IRS Employee Identification Number (EIN) for US-based or foreign companies with EIN. The numeric portion of Tax ID for companies incorporated in other countries.

ein_taxid_countrystring required

2-letter ISO country code of the Tax ID issuing country

websitestring

The website of the business

stock_symbolstring nullable required

The stock symbol of the Brand. For PUBLIC_PROFIT Brands only.

stock_exchangestring nullable required

The stock exchange code. For PUBLIC_PROFIT Brands only.

first_namestring required

The first name of the business contact

last_namestring required

The last name of the business contact

phone_numberstring required

The support contact telephone in E.164 format

emailstring email required

The email address of the support contact

street_addressstring required

Street name and house number

citystring required

The city name

state_or_provincestring nullable required

State or province. For the United States, use 2 character codes.

zipstring required

The business zip or postal code

countrystring required

2-letter ISO country code the business address

mockboolean

Indicates a mock Brand. Mock Brands are for testing purposes only; production traffic with mock Brands is prohibited.

Example request

{
  "dba_name": "Brand",
  "company_name": "Company",
  "entity_type": "PUBLIC_PROFIT",
  "vertical": "PROFESSIONAL",
  "ein_taxid": "12-2142342",
  "ein_taxid_country": "US",
  "website": "Tess.com",
  "stock_symbol": null,
  "stock_exchange": "NASDAQ",
  "first_name": "John",
  "last_name": "Doe",
  "phone_number": "12046661776",
  "email": "support@brand.com",
  "street_address": "10, Street name",
  "city": "Miami",
  "state_or_province": "AL",
  "zip": "12345",
  "country": "US",
  "mock": false
}

Response

Returns the registered 10DLC Brand.

brand_idstring required

Unique identifier of the Brand assigned by the registry.

dba_namestring required

Doing-business-as name, or the public-facing brand name.

company_namestring required

Registered legal name of the company that owns the Brand.

entity_type'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' required

Company entity type.

verticalstring required

Industry vertical the Brand operates in.

ein_taxidstring required

IRS Employer Identification Number (EIN) or other tax ID of the company.

ein_taxid_countrystring required

ISO 3166-1 alpha-2 country code where the Tax ID was issued.

status'REVIEW' | 'VERIFIED' | 'UNVERIFIED' | 'VETTED_VERIFIED' | 'SUSPENDED' required

Brand identity verification status.

websitestring nullable

Business website URL.

stock_symbolstring nullable

Stock ticker symbol of the company. Required for publicly traded companies.

stock_exchangestring nullable

Code of the stock exchange the company is listed on. Required for publicly traded companies.

first_namestring required

Business contact first name.

last_namestring required

Business contact last name.

phone_numberstring required

Support contact phone number in E.164 format.

emailstring required

Support contact email address.

street_addressstring required

Street address of the business.

citystring required

City of the business address.

state_or_provincestring nullable

State or province of the business address.

countrystring required

ISO 3166-1 alpha-2 country code of the business address.

zipstring required

ZIP or postal code of the business address.

feedbackstring nullable required

Feedback from the identity verification process explaining the current status.

mockboolean

Indicates whether the Brand is a mock brand for testing.

created_atstring required

Timestamp when the Brand was created, in ISO 8601 format.

updated_atstring required

Timestamp when the Brand was last updated, in ISO 8601 format.

Example response

{
  "brand_id": "BM20QP9",
  "city": "Miami",
  "company_name": "Company legal name",
  "country": "US",
  "created_at": "2024-07-24T08:10:49",
  "dba_name": "New Brand",
  "ein_taxid": "99999999",
  "ein_taxid_country": "US",
  "email": "support@brand.com",
  "entity_type": "PRIVATE_PROFIT",
  "feedback": null,
  "first_name": "John",
  "last_name": "Dow",
  "mock": false,
  "phone_number": "12123450099",
  "state_or_province": "FL",
  "status": "REVIEW",
  "stock_exchange": null,
  "stock_symbol": null,
  "street_address": "10, Street Name",
  "updated_at": "2024-07-24T08:10:49",
  "vertical": "HEALTHCARE",
  "website": "https://brand.com",
  "zip": "12345"
}