v77

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-012528701.8 MB

Campaign Registry: Brands

Get brand

Retrieves the details of a brand.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Messaging and Numbers.

Learn more about API scopes.

get/api/relay/rest/registry/beta/brands/{id}

Path parameters

idstring uuid required

Universal Unique Identifier.

Unique ID of the brand.

Response

The request has succeeded.

idstring uuid required

Universal Unique Identifier.

statestring

The current state of the brand.

namestring

Brand/Marketing/DBA name of the business if applicable.

company_namestring

The legal name of the business.

contact_emailstring

A company contact email for this brand.

contact_phonestring

A contact phone number for this brand.

ein_issuing_countrystring

Country of registration.

legal_entity_typestring

What type of legal entity is the organization? (PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT)

einstring

Company EIN Number/Tax ID.

company_addressstring

Full company address.

company_verticalstring

An optional Vertical for the brand (REAL_ESTATE, HEALTHCARE, ENERGY, ENTERTAINMENT, RETAIL, AGRICULTURE, INSURANCE, EDUCATION, HOSPITALITY, FINANCIAL, GAMBLING, CONSTRUCTION, NGO, MANUFACTURING, GOVERNMENT, TECHNOLOGY, COMMUNICATION).

company_websitestring

Link to the company website.

csp_brand_referencestring

If you are your own Campaign Service Provider, this is the approved Brand ID (Mandatory for CSPs, otherwise please omit).

csp_self_registeredboolean

This value must be true for all self-registered brands.

status_callback_urlstring

Optional: Specify a URL to receive webhook notifications when your brand's state changes. See the 10DLC status callback docs for the webhook payload.

created_atstring date-time

Timestamp when the brand was created.

updated_atstring date-time

Timestamp when the brand was last updated.

Example response

{
  "state": "pending",
  "name": "My Brand",
  "company_name": "BrandCo",
  "contact_email": "brand_info@example.com",
  "contact_phone": "+18995551212",
  "ein_issuing_country": "United States",
  "legal_entity_type": "Private Company",
  "ein": "12-3456789",
  "company_address": "123 Brand St, Hill Valley CA, 91905",
  "company_vertical": "Healthcare",
  "company_website": "www.example.com",
  "status_callback_url": "https://example.com/handle_callback"
}