Skip to main content
GET
cURL

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID (MA_XXXXXXXX).

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token.

Response

All brands on your account.

​
id
string<uuid>

Brand ID (UUID) on your account. Use it in every /10dlc/brands/{id} path and as brandId when you create a campaign.

Example:

"5f1c3a2e-7b4d-4e8f-9a0b-1c2d3e4f5a60"

​
accountId
string

Your Vobiz account ID (MA_...). Always the account whose credentials made the request.

Example:

"MA_XXXXXXXX"

​
name
string

Display name you gave the brand when you created it.

Example:

"Example Corp"

​
legalName
string

Registered legal name of the business. Omitted when not set.

Example:

"Example Corporation Inc."

​
brandType
enum<string>

Kind of business behind the brand: TENDLC_PRIVATE_COMPANY (privately held business), TENDLC_PUBLIC_COMPANY (publicly traded company; also goes through brand authentication), TENDLC_NON_PROFIT (registered non-profit), TENDLC_GOVERNMENT (government body) or TOLL_FREE_NUMBER (a business registered for toll-free messaging).

Available options:
TENDLC_PRIVATE_COMPANY,
TENDLC_PUBLIC_COMPANY,
TENDLC_NON_PROFIT,
TENDLC_GOVERNMENT,
TOLL_FREE_NUMBER
​
stage
enum<string>

Where the brand is in your workflow: DRAFT until you call POST /10dlc/brands/{id}/register, then SUBMITTED.

Available options:
DRAFT,
SUBMITTED
​
registrationStatus
enum<string>

The registrar's decision, present once the brand is submitted. PENDING while under review, PENDING_2FA while a public company's business contact completes brand authentication, PENDING_APPEAL while an appeal is reviewed, ACTIVE when approved and REJECTED when declined (see rejectionReasons).

Available options:
ACTIVE,
PENDING,
PENDING_2FA,
PENDING_APPEAL,
REJECTED
​
brandIdentityStatus
string

Identity verification result from the registry, for example VERIFIED, UNVERIFIED or VETTED_VERIFIED. Omitted until the registry reports one.

Example:

"VERIFIED"

​
rejectionReasons
object[]

Rejections recorded by registrars, one entry per registrar. Omitted when there are none; fix the brand with PUT /10dlc/brands/{id} and register it again.

​
website
string<uri>

Business website as submitted to the registry. Omitted when not set.

Example:

"https://example.com"

​
supportEmail
string

Support email address for the business. Omitted when not set.

Example:

"support@example.com"

​
supportPhone
string

Support phone number for the business, in E.164 format. Omitted when not set.

Example:

"+14155550100"

​
vertical
string

Industry vertical code as submitted to the registry, for example TECHNOLOGY. Omitted when not set.

Example:

"TECHNOLOGY"

​
taxId
string

Tax identifier of the business, for example a US EIN. Omitted when not set.

Example:

"12-3456789"

​
taxIdIssuingCountry
string

ISO 3166-1 alpha-2 code of the country that issued taxId, for example US. Omitted when not set.

Example:

"US"

​
countryCode
string

ISO 3166-1 alpha-2 code of the country where the business is registered. Omitted when not set.

Example:

"US"

​
address
object

Postal address of the business as submitted to the registry. Omitted when not set.

​
alternateBusinessId
object

Alternate business identifier (for example a DUNS or LEI record), returned as you sent it. Omitted when not set.

​
businessContactFirstName
string

First name of the business contact the registry can reach. Omitted when not set.

Example:

"Alex"

​
businessContactLastName
string

Last name of the business contact the registry can reach. Omitted when not set.

Example:

"Doe"

​
businessContactEmail
string

Email address of the business contact; brand-authentication and 2FA requests go here. Omitted when not set.

Example:

"alex.doe@example.com"

​
businessDba
string

Trading name ("doing business as") when it differs from legalName. Omitted when not set.

​
legalEntityType
string

Legal entity type as submitted to the registry, for example PRIVATE_COMPANY. Omitted when not set.

Example:

"PRIVATE_COMPANY"

​
businessRegistrationType
string

Type of business registration number for a business outside the US, for example VAT. Omitted when not set.

​
stockExchange
string

Exchange where a TENDLC_PUBLIC_COMPANY brand is listed. Omitted when not set.

​
stockSymbol
string

Ticker symbol of a TENDLC_PUBLIC_COMPANY brand. Omitted when not set.

​
taxExemptStatus
string

Tax-exempt status of a TENDLC_NON_PROFIT brand. Omitted when not set.

​
lastSyncedAt
string<date-time>

When Vobiz last refreshed this record from the US 10DLC registry, in ISO 8601 (RFC 3339) UTC. Omitted until the first refresh.

Example:

"2026-10-12T10:35:00Z"

​
createdAt
string<date-time>

When the record was created on your account, in ISO 8601 (RFC 3339) UTC.

Example:

"2026-10-12T10:30:00Z"

​
updatedAt
string<date-time>

When the record last changed on your account, in ISO 8601 (RFC 3339) UTC.

Example:

"2026-10-12T10:35:00Z"