> ## Documentation Index > Fetch the complete documentation index at: https://www.vobiz.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # List brands > Returns every brand on your account as a bare JSON array, newest first. The list is not paginated and reads the records stored on your account without contacting the registry; deleted brands are left out. ## OpenAPI ````yaml openapi-sms.yaml GET /10dlc/brands openapi: 3.0.3 info: title: Vobiz Messaging API description: > Send and receive SMS, MMS and RCS messages, buy messaging numbers, register for US 10DLC and toll-free, run broadcasts, manage conversations, opt-outs and webhooks. **Base URL:** `https://api.vobiz.ai/api/v1/sms` **Authentication:** every request needs the `X-Auth-ID` and `X-Auth-Token` headers. The account is taken from your credentials; you never put an account ID in a path or body. Field names in this API are camelCase. version: '1.0' contact: email: support@vobiz.ai url: https://vobiz.ai servers: - url: https://api.vobiz.ai/api/v1/sms description: Production security: - AuthID: [] AuthToken: [] tags: - name: Messages description: Send messages and inspect their delivery state. - name: Numbers description: >- Messaging-capable numbers on your account, inventory search, purchase and release. - name: Coverage description: Where you can send, per country. - name: Conversations description: Two-way threads between one of your numbers and a contact. - name: Opt-outs description: Numbers that must not receive messages on a channel. - name: Webhooks description: Subscriptions that deliver message and broadcast events to your server. - name: Broadcasts description: Bulk sends from an uploaded recipient list. - name: RCS Senders description: RCS sender (agent) identities and their message templates. - name: 10DLC Brands description: US 10DLC brand registration. - name: 10DLC Campaigns description: US 10DLC campaigns, toll-free verification and supporting documents. paths: /10dlc/brands: get: tags: - 10DLC Brands summary: List brands description: >- Returns every brand on your account as a bare JSON array, newest first. The list is not paginated and reads the records stored on your account without contacting the registry; deleted brands are left out. Call `GET /10dlc/brands/{id}` for the latest registry state of one brand. operationId: list-brands responses: '200': description: All brands on your account. content: application/json: schema: type: array items: $ref: '#/components/schemas/Brand' example: - id: 5f1c3a2e-7b4d-4e8f-9a0b-1c2d3e4f5a60 accountId: MA_XXXXXXXX name: Example Corp legalName: Example Corporation Inc. brandType: TENDLC_PRIVATE_COMPANY stage: SUBMITTED registrationStatus: ACTIVE brandIdentityStatus: VERIFIED website: https://example.com supportEmail: support@example.com supportPhone: '+14155550100' vertical: TECHNOLOGY taxId: 12-3456789 taxIdIssuingCountry: US countryCode: US address: street: 100 Example Street city: San Francisco state: CA zipCode: '94105' businessContactFirstName: Alex businessContactLastName: Doe lastSyncedAt: '2026-10-16T21:17:05Z' createdAt: '2026-10-06T08:58:02Z' updatedAt: '2026-10-06T18:51:11Z' '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/ServerError' x-codeSamples: - lang: typescript label: Node SDK source: > import { VobizClient } from "@vobiz/sdk"; const client = new VobizClient({ apiKey: "MA_XXXXXXXX", authToken: "YOUR_AUTH_TOKEN" }); await client.sms.brands.listBrands() - lang: python label: Python SDK source: | from vobiz import Vobiz client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN") client.sms.brands.list_brands() - lang: go label: Go SDK source: | import ( "context" vobiz "github.com/vobiz-ai/Vobiz-Go-SDK" "github.com/vobiz-ai/Vobiz-Go-SDK/client" "github.com/vobiz-ai/Vobiz-Go-SDK/option" "github.com/vobiz-ai/Vobiz-Go-SDK/sms" ) c := client.NewClient( option.WithAPIKey("MA_XXXXXXXX"), option.WithAuthToken("YOUR_AUTH_TOKEN"), ) c.Sms.Brands.ListBrands( context.TODO(), ) - lang: java label: Java SDK source: | import com.vobiz.api.VobizApiClient; VobizApiClient client = VobizApiClient .builder() .apiKey("MA_XXXXXXXX") .authToken("YOUR_AUTH_TOKEN") .build(); client.sms().brands().listBrands(); - lang: ruby label: Ruby SDK source: > require 'vobiz' client = Vobiz::Client.new(api_key: 'MA_XXXXXXXX', auth_token: 'YOUR_AUTH_TOKEN') client.sms.brands.list_brands - lang: csharp label: C# SDK source: | using Vobiz; using Vobiz.Sms; var client = new VobizApiClient("YOUR_AUTH_TOKEN", "MA_XXXXXXXX"); await client.Sms.Brands.ListBrandsAsync(); - lang: php label: PHP SDK source: > sms->brands->listBrands(); components: schemas: Brand: type: object description: >- A brand on your account: the business behind your 10DLC traffic and its state at the US 10DLC registry. Optional fields are omitted when empty, and registry state is refreshed when you retrieve the brand. properties: id: type: string format: uuid description: >- 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: type: string example: MA_XXXXXXXX description: >- Your Vobiz account ID (`MA_...`). Always the account whose credentials made the request. name: type: string example: Example Corp description: Display name you gave the brand when you created it. legalName: type: string example: Example Corporation Inc. description: Registered legal name of the business. Omitted when not set. brandType: type: string enum: - TENDLC_PRIVATE_COMPANY - TENDLC_PUBLIC_COMPANY - TENDLC_NON_PROFIT - TENDLC_GOVERNMENT - TOLL_FREE_NUMBER description: >- 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). stage: type: string enum: - DRAFT - SUBMITTED description: >- Where the brand is in your workflow: `DRAFT` until you call `POST /10dlc/brands/{id}/register`, then `SUBMITTED`. registrationStatus: type: string enum: - ACTIVE - PENDING - PENDING_2FA - PENDING_APPEAL - REJECTED description: >- 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`). brandIdentityStatus: type: string description: >- Identity verification result from the registry, for example `VERIFIED`, `UNVERIFIED` or `VETTED_VERIFIED`. Omitted until the registry reports one. example: VERIFIED rejectionReasons: type: array description: >- 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. items: $ref: '#/components/schemas/BrandRejectionReason' website: type: string format: uri example: https://example.com description: Business website as submitted to the registry. Omitted when not set. supportEmail: type: string example: support@example.com description: Support email address for the business. Omitted when not set. supportPhone: type: string example: '+14155550100' description: >- Support phone number for the business, in E.164 format. Omitted when not set. vertical: type: string example: TECHNOLOGY description: >- Industry vertical code as submitted to the registry, for example `TECHNOLOGY`. Omitted when not set. taxId: type: string example: 12-3456789 description: >- Tax identifier of the business, for example a US EIN. Omitted when not set. taxIdIssuingCountry: type: string example: US description: >- ISO 3166-1 alpha-2 code of the country that issued `taxId`, for example `US`. Omitted when not set. countryCode: type: string example: US description: >- ISO 3166-1 alpha-2 code of the country where the business is registered. Omitted when not set. address: allOf: - $ref: '#/components/schemas/BrandAddress' description: >- Postal address of the business as submitted to the registry. Omitted when not set. alternateBusinessId: type: object additionalProperties: true description: >- Alternate business identifier (for example a DUNS or LEI record), returned as you sent it. Omitted when not set. businessContactFirstName: type: string example: Alex description: >- First name of the business contact the registry can reach. Omitted when not set. businessContactLastName: type: string example: Doe description: >- Last name of the business contact the registry can reach. Omitted when not set. businessContactEmail: type: string example: alex.doe@example.com description: >- Email address of the business contact; brand-authentication and 2FA requests go here. Omitted when not set. businessDba: type: string description: >- Trading name ("doing business as") when it differs from `legalName`. Omitted when not set. legalEntityType: type: string example: PRIVATE_COMPANY description: >- Legal entity type as submitted to the registry, for example `PRIVATE_COMPANY`. Omitted when not set. businessRegistrationType: type: string description: >- Type of business registration number for a business outside the US, for example `VAT`. Omitted when not set. stockExchange: type: string description: >- Exchange where a `TENDLC_PUBLIC_COMPANY` brand is listed. Omitted when not set. stockSymbol: type: string description: >- Ticker symbol of a `TENDLC_PUBLIC_COMPANY` brand. Omitted when not set. taxExemptStatus: type: string description: >- Tax-exempt status of a `TENDLC_NON_PROFIT` brand. Omitted when not set. lastSyncedAt: type: string format: date-time description: >- 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: type: string format: date-time example: '2026-10-12T10:30:00Z' description: >- When the record was created on your account, in ISO 8601 (RFC 3339) UTC. updatedAt: type: string format: date-time example: '2026-10-12T10:35:00Z' description: >- When the record last changed on your account, in ISO 8601 (RFC 3339) UTC. BrandRejectionReason: type: object description: One rejection recorded by a registrar for the brand. properties: registrar: type: string description: Registrar that recorded the rejection. example: TCR state: type: string description: >- The brand's state at that registrar when the rejection was recorded. Omitted when not reported. example: REJECTED rejectionReason: type: string example: Tax ID does not match the legal name on file. description: >- The registrar's explanation of what to fix before you register again. BrandAddress: type: object description: >- Postal address of the business. Keys are passed to the US 10DLC registry as given, so you can add any address key the registry accepts. additionalProperties: true properties: street: type: string example: 100 Example Street description: Street address, including number and suite. city: type: string example: San Francisco description: City or locality. state: type: string example: CA description: >- State, province or region; for US addresses, the two-letter state code (for example `CA`). zipCode: type: string example: '94105' description: ZIP or postal code, as a string (for example `94105`). Error: type: object description: >- The body of every error response: a flat object with one `error` string that explains what went wrong. Use the HTTP status code to decide how to handle the error, and log `error` for diagnosis. required: - error properties: error: type: string example: 'recipient has opted out: +14155550123' description: >- Human-readable explanation of the error, for example `phoneNumber is required` or `recipient has opted out: +14155550123`. Branch on the HTTP status code rather than on this text. responses: Unauthorized: description: Missing or invalid `X-Auth-ID` / `X-Auth-Token`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: missing or invalid credentials ServerError: description: Unexpected error. Retry with the same idempotency key where one applies. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: internal error securitySchemes: AuthID: type: apiKey in: header name: X-Auth-ID description: Your Vobiz account Auth ID (`MA_XXXXXXXX`). AuthToken: type: apiKey in: header name: X-Auth-Token description: Your Vobiz account Auth Token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.