> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wavix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List 10DLC Brands

> Returns a paginated list of 10DLC Brands for the authenticated account, filtered by date, name, legal name, and status.



## OpenAPI

````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml get /v3/10dlc/brands
openapi: 3.1.0
info:
  title: Wavix APIs
  description: >-
    Wavix provides robust APIs that let you integrate voice and text messaging
    features directly into your app. Send text, place calls, and access detailed
    reports  programmatically.
  termsOfService: https://wavix.com/terms-and-conditions
  license:
    name: MIT
    identifier: MIT
  contact:
    name: Wavix
    url: https://wavix.com
    email: support@wavix.com
  version: '1.0'
servers:
  - url: https://api.wavix.com
    description: https://api.wavix.com
    variables: {}
security:
  - bearerAuth: []
tags:
  - name: SIP trunks
    description: SIP trunks
  - name: Buy
    description: Numbers
  - name: Cart
    description: Numbers
  - name: My numbers
    description: Numbers
  - name: Billing
    description: Billing, transactions, and invoices
  - name: Profile
    description: Account profile and customer information
  - name: CDRs
    description: Call detail records and call history
  - name: Speech Analytics
    description: Call transcription and speech analytics
  - name: SMS and MMS
    description: Messaging
  - name: Number Validator
    description: Phone number validation
  - name: Link shortener
    description: Short link and click metrics
  - name: 2FA
    description: Two-factor authentication
  - name: 10DLC
    description: 10DLC Campaigns and Brands
  - name: API Keys
    description: API key management
  - name: Call webhooks
    description: Webhook configuration for call events
  - name: Call control
    description: Programmable Voice
  - name: Call streaming
    description: Real-time call audio streaming over WebSocket
  - name: Call recording
    description: Call recording
  - name: Sub-accounts
    description: Sub-account management
  - name: Voice campaigns
    description: Outbound voice campaigns
  - name: Wavix Embeddable
    description: WebRTC embeddable widget
paths:
  /v3/10dlc/brands:
    get:
      tags:
        - 10DLC
      summary: List 10DLC Brands
      description: >-
        Returns a paginated list of 10DLC Brands for the authenticated account,
        filtered by date, name, legal name, and status.
      operationId: ten_dlc_brands_list
      parameters:
        - name: dba_name
          in: query
          description: >-
            Filters Brands by `dba_name` (doing-business-as name). Matches
            partial values.
          style: form
          explode: true
          schema:
            type: string
            example: Brand
        - name: company_name
          in: query
          description: >-
            Filters Brands by `company_name` (registered legal name). Matches
            partial values.
          style: form
          explode: true
          schema:
            type: string
            example: Company
        - name: entity_type
          in: query
          description: Filters Brands by business entity type, such as `PRIVATE_PROFIT`.
          style: form
          explode: true
          schema:
            type: string
            example: PRIVATE_PROFIT
        - name: status
          in: query
          description: Filters Brands by identity verification status, such as `VERIFIED`.
          style: form
          explode: true
          schema:
            type: string
            example: VERIFIED
        - name: country
          in: query
          description: >-
            Filters Brands by registration country, as an ISO 3166-1 alpha-2
            code (e.g., `US`).
          style: form
          explode: true
          schema:
            type: string
            example: US
        - name: show_deleted
          in: query
          description: >-
            When `true`, includes deleted Brands in the results. Default
            `false`.
          style: form
          explode: true
          schema:
            type: boolean
            default: false
            example: false
        - name: ein_taxid
          in: query
          description: >-
            Filters Brands by their Employer Identification Number (EIN) or tax
            ID.
          style: form
          explode: true
          schema:
            type: string
            example: '999999999'
        - name: mock
          in: query
          description: >-
            When `true`, returns only mock Brands used for testing. Default
            `false`.
          style: form
          explode: true
          schema:
            type: boolean
            default: false
            example: false
        - name: created_before
          in: query
          description: >-
            Returns brands created on or before this date, in `YYYY-MM-DD`
            format.
          style: form
          explode: true
          schema:
            type: string
            example: '2024-08-22'
        - name: created_after
          in: query
          description: >-
            Returns brands created on or after this date, in `YYYY-MM-DD`
            format.
          style: form
          explode: true
          schema:
            type: string
            example: '2024-08-22'
        - name: page
          in: query
          description: Page number to retrieve. Default `1`.
          style: form
          explode: true
          schema:
            type: integer
            format: int32
            example: 1
        - name: per_page
          in: query
          description: Number of records to return per page. Default `25`.
          style: form
          explode: true
          schema:
            type: integer
            format: int32
            example: 25
      responses:
        '200':
          description: Returns a paginated list of 10DLC Brands.
          headers: {}
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/TenDLCBrandListResponse'
                  - example:
                      items:
                        - brand_id: BM20QP9
                          city: Miami
                          company_name: Company legal name
                          country: US
                          created_at: '2024-07-24T08:10:49'
                          dba_name: New Brand
                          ein_taxid: '999999999'
                          ein_taxid_country: US
                          email: support@brand.com
                          entity_type: PRIVATE_PROFIT
                          feedback: null
                          first_name: John
                          last_name: Dow
                          mock: false
                          phone_number: '12123450099'
                          state_or_province: FL
                          status: VERIFIED
                          stock_exchange: null
                          stock_symbol: null
                          street_address: 10, Street Name
                          updated_at: '2024-07-24T08:29:09'
                          vertical: HEALTHCARE
                          website: https://brand.com
                          zip: '12345'
                      pagination:
                        current_page: 1
                        per_page: 25
                        total: 1
                        total_pages: 1
              examples:
                default:
                  value:
                    items:
                      - brand_id: BM20QP9
                        city: Miami
                        company_name: Company legal name
                        country: US
                        created_at: '2024-07-24T08:10:49'
                        dba_name: New Brand
                        ein_taxid: '999999999'
                        ein_taxid_country: US
                        email: support@brand.com
                        entity_type: PRIVATE_PROFIT
                        feedback: null
                        first_name: John
                        last_name: Dow
                        mock: false
                        phone_number: '12123450099'
                        state_or_province: FL
                        status: VERIFIED
                        stock_exchange: null
                        stock_symbol: null
                        street_address: 10, Street Name
                        updated_at: '2024-07-24T08:29:09'
                        vertical: HEALTHCARE
                        website: https://brand.com
                        zip: '12345'
                    pagination:
                      current_page: 1
                      per_page: 25
                      total: 1
                      total_pages: 1
        '400':
          $ref: '#/components/responses/BadRequestErrorResponse'
        '403':
          description: Returns when the 10DLC feature is disabled for the account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
              examples:
                success:
                  summary: Successful response
                  value:
                    success: false
                    message: Request failed. The feature is disabled for the account.
      deprecated: false
      security:
        - bearerAuth:
            - campaigns:read
components:
  schemas:
    TenDLCBrandListResponse:
      title: TenDLCBrandListResponse
      required:
        - items
        - pagination
      type: object
      additionalProperties: false
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/TenDLCBrand'
          description: A paginated list of 10DLC Brands matching the filter criteria
        pagination:
          allOf:
            - $ref: '#/components/schemas/Pagination'
            - description: Pagination details
      description: A list of 10DLC Brands
      example:
        items:
          - brand_id: BM20QP9
            city: Miami
            company_name: Company legal name
            country: US
            created_at: '2024-07-24T08:10:49'
            dba_name: New Brand
            ein_taxid: '12345'
            ein_taxid_country: US
            email: support@brand.com
            entity_type: PRIVATE_PROFIT
            feedback: null
            first_name: John
            last_name: Dow
            mock: false
            phone_number: '12123450099'
            state_or_province: FL
            status: VERIFIED
            stock_exchange: null
            stock_symbol: null
            street_address: 10, Street name
            updated_at: '2024-07-24T08:29:09'
            vertical: HEALTHCARE
            website: https://brand.com
            zip: '12345'
        pagination:
          current_page: 1
          per_page: 25
          total: 1
          total_pages: 1
    AccountErrorResponse:
      title: AccountErrorResponse
      required:
        - success
        - message
      type: object
      properties:
        success:
          type: boolean
          description: Indicates whether the request was successful
          example: false
        message:
          type: string
          description: Human-readable error description
          example: Request failed. The feature is disabled for the account.
      description: The feature is disabled for the account.
    TenDLCBrand:
      title: TenDLCBrand
      required:
        - brand_id
        - dba_name
        - company_name
        - entity_type
        - vertical
        - ein_taxid
        - ein_taxid_country
        - status
        - first_name
        - last_name
        - phone_number
        - email
        - street_address
        - city
        - country
        - zip
        - feedback
        - created_at
        - updated_at
      type: object
      additionalProperties: false
      properties:
        brand_id:
          type: string
          description: Unique identifier of the Brand assigned by the registry.
          example: BM20QP9
        dba_name:
          type: string
          description: Doing-business-as name, or the public-facing brand name.
          example: Brand
        company_name:
          type: string
          description: Registered legal name of the company that owns the Brand.
          example: Company
        entity_type:
          allOf:
            - $ref: '#/components/schemas/TenDLCBrandEntityType'
            - description: Company entity type.
              example: PRIVATE_PROFIT
        vertical:
          type: string
          description: Industry vertical the Brand operates in.
          example: HEALTHCARE
        ein_taxid:
          type: string
          description: >-
            IRS Employer Identification Number (EIN) or other tax ID of the
            company.
          example: '999999999'
        ein_taxid_country:
          type: string
          description: ISO 3166-1 alpha-2 country code where the Tax ID was issued.
          example: US
        status:
          allOf:
            - $ref: '#/components/schemas/TenDLCBrandIdentityVerificationStatus'
            - description: Brand identity verification status.
              example: VERIFIED
        website:
          type:
            - string
            - 'null'
          description: Business website URL.
          example: https://brand.com
        stock_symbol:
          type:
            - string
            - 'null'
          description: >-
            Stock ticker symbol of the company. Required for publicly traded
            companies.
        stock_exchange:
          type:
            - string
            - 'null'
          description: >-
            Code of the stock exchange the company is listed on. Required for
            publicly traded companies.
        first_name:
          type: string
          description: Business contact first name.
          example: John
        last_name:
          type: string
          description: Business contact last name.
          example: Dow
        phone_number:
          type: string
          description: Support contact phone number in E.164 format.
          example: '12123450099'
        email:
          type: string
          description: Support contact email address.
          example: support@brand.com
        street_address:
          type: string
          description: Street address of the business.
          example: 10, City Name
        city:
          type: string
          description: City of the business address.
          example: Miami
        state_or_province:
          type:
            - string
            - 'null'
          description: State or province of the business address.
          example: FL
        country:
          type: string
          description: ISO 3166-1 alpha-2 country code of the business address.
          example: US
        zip:
          type: string
          description: ZIP or postal code of the business address.
          example: '12345'
        feedback:
          type:
            - string
            - 'null'
          description: >-
            Feedback from the identity verification process explaining the
            current `status`.
        mock:
          type: boolean
          description: Indicates whether the Brand is a mock brand for testing.
          default: false
          example: false
        created_at:
          type: string
          description: Timestamp when the Brand was created, in ISO 8601 format.
          example: '2024-07-24T08:29:09'
        updated_at:
          type: string
          description: Timestamp when the Brand was last updated, in ISO 8601 format.
          example: '2024-07-24T08:29:09'
      description: >-
        Represents a 10DLC brand registered for application-to-person messaging.
        A Brand identifies the business behind one or more messaging campaigns.
      example:
        brand_id: BM20QP9
        city: Miami
        company_name: Company legal name
        country: US
        created_at: '2024-07-24T08:10:49'
        dba_name: New Brand
        ein_taxid: '12345'
        ein_taxid_country: US
        email: support@brand.com
        entity_type: PRIVATE_PROFIT
        feedback: null
        first_name: John
        last_name: Dow
        mock: false
        phone_number: '12123450099'
        state_or_province: FL
        status: VERIFIED
        stock_exchange: null
        stock_symbol: null
        street_address: 10, Street name
        updated_at: '2024-07-24T08:29:09'
        vertical: HEALTHCARE
        website: https://brand.com
        zip: '12345'
    Pagination:
      title: Pagination
      required:
        - current_page
        - per_page
        - total
        - total_pages
      type: object
      additionalProperties: false
      properties:
        current_page:
          type: integer
          description: Current page number.
          format: int32
          example: 2
        per_page:
          type: integer
          description: Number of records per page.
          format: int32
          example: 25
        total:
          type: integer
          description: Total number of records.
          format: int32
          example: 101
        total_pages:
          type: integer
          description: Total number of pages.
          format: int32
          example: 5
    ValidationErrorResponse:
      title: ValidationErrorResponse
      type: object
      properties:
        success:
          type: boolean
          description: >-
            Indicates whether the request was successful. Always `false` for
            this error.
          example: false
        message:
          type: string
          description: >-
            Human-readable description naming the missing or invalid request
            parameter.
          example: Missing or invalid parameter <param_name>
    TenDLCBrandEntityType:
      title: TenDLCBrandEntityType
      enum:
        - PRIVATE_PROFIT
        - PUBLIC_PROFIT
        - NON_PROFIT
        - GOVERNMENT
      type: string
      description: >-
        Legal entity type of the 10DLC Brand. One of `PRIVATE_PROFIT` (privately
        held for-profit company), `PUBLIC_PROFIT` (publicly traded for-profit
        company), `NON_PROFIT` (non-profit organization), or `GOVERNMENT`
        (government entity).
      example: PRIVATE_PROFIT
    TenDLCBrandIdentityVerificationStatus:
      title: TenDLCBrandIdentityVerificationStatus
      enum:
        - REVIEW
        - VERIFIED
        - UNVERIFIED
        - VETTED_VERIFIED
        - SUSPENDED
      type: string
      description: |-
        Identity verification status of the 10DLC Brand. One of:

        - `REVIEW` — verification is in progress.
        - `VERIFIED` — the Brand passed standard verification.
        - `UNVERIFIED` — verification has not succeeded.
        - `VETTED_VERIFIED` — the Brand also passed third-party vetting.
        - `SUSPENDED` — the Brand is blocked from sending.
  responses:
    BadRequestErrorResponse:
      description: Request failed. Missing or invalid parameter <param_name>
      headers: {}
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ValidationErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >
        Wavix API key. Pass as `Authorization: Bearer <api_key>`. Keys support
        per-resource scopes (none / read / write). See [Restricted keys and
        scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes).

````