Skip to navigation

List 10DLC brands

View as Markdown

Lists the account’s business 10DLC brands that are either reusable (they have an approved registration, so a new campaign can be registered under them with brandId) or carry a campaign a number can be added to with campaignId. The reusable field on each brand says which.

A brand is the business identity carriers vet; a campaign is one messaging use case beneath it. One brand can carry several campaigns, so a second use case — say event reminders alongside order confirmations — is a new campaign on the brand you already have, not a second registration of the same business. Reusing the brand keeps its approval and its vetting score, and skips the wait for both.

Two conditions decide what a brand can be used for, and both come from the carrier registry rather than from Dial:

  • The brand is approved. The registry refuses a new campaign filed against a brand it hasn’t approved yet, so such a brand has reusable: false — it is listed only if it has a campaign you can add numbers to.
  • The brand is a business. A sole proprietor brand covers exactly one use case and one number, so it can never carry a second campaign.

An account with nothing to reuse gets an empty list — that’s a successful answer, not a 404.

Authentication

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

Response

Business brands you can register a new campaign under (reusable) or add numbers to (campaigns), newest approval first; brands with no approval yet come last.

brandslist of objectsOptional

Errors

401
Unauthorized Error