List 10DLC brands
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
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.