> ## 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 Campaigns

> Returns a paginated list of 10DLC Campaigns for the authenticated account, filtered by date, status, and use case.



## OpenAPI

````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml get /v3/10dlc/brands/campaigns
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/campaigns:
    get:
      tags:
        - 10DLC
      summary: List 10DLC Campaigns
      description: >-
        Returns a paginated list of 10DLC Campaigns for the authenticated
        account, filtered by date, status, and use case.
      operationId: ten_dlc_campaigns_list
      parameters:
        - name: name
          in: query
          description: Filters Campaigns by name. Matches partial values.
          style: form
          explode: true
          schema:
            type: string
            example: Name
        - name: usecase
          in: query
          description: Filters Campaigns by use case.
          style: form
          explode: true
          schema:
            type: string
            example: 2FA
        - name: status
          in: query
          description: Filters Campaigns by status.
          style: form
          explode: true
          schema:
            type: string
            example: APPROVED
        - name: mock
          in: query
          description: >-
            When `true`, returns only mock Campaigns used for testing. Default
            `false`.
          style: form
          explode: true
          schema:
            type: boolean
            default: false
            example: true
        - name: created_before
          in: query
          description: >-
            Returns Campaigns created on or before this date, in `YYYY-MM-DD`
            format.
          style: form
          explode: true
          schema:
            type: string
            format: date
            example: '2024-08-22'
        - name: created_after
          in: query
          description: >-
            Returns Campaigns created on or after this date, in `YYYY-MM-DD`
            format.
          style: form
          explode: true
          schema:
            type: string
            format: date
            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 Campaigns.
          headers: {}
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/TenDLCCampaignListResponse'
                  - example:
                      items:
                        - affiliate_marketing: false
                          age_gated: false
                          auto_renewal: false
                          brand_id: BM20QP9
                          campaign_id: CKLCK95
                          created_at: '2024-08-14T11:57:41'
                          description: Our campaign aims to …
                          direct_lending: false
                          embedded_link_sample: null
                          embedded_links: false
                          embedded_phones: false
                          feedback: null
                          help: true
                          help_keywords: help
                          help_message: >-
                            For help, please visit www.site.com. To opt-out,
                            reply STOP.
                          last_bill_date: '2024-08-14T11:57:42'
                          mock: false
                          monthly_fee: '10.0'
                          name: My first campaign
                          next_bill_date: '2024-11-14T00:00:00'
                          optin: true
                          optin_keywords: begin,start
                          optin_message: >-
                            You are now opted-in for help please reply HELP, to
                            stop please reply STOP
                          optin_workflow: Our SMS ...
                          optout: true
                          optout_keywords: stop,quit,unsubscribe
                          optout_message: >-
                            You are now opted out and will receive no further
                            messages
                          privacy_policy: https://site.com/privacy-policy
                          sample1: Your verification code is XXXXXX
                          sample2: XXXX is your verification code
                          sample3: null
                          sample4: null
                          sample5: null
                          status: APPROVED
                          terms_conditions: https://site.com/terms-and-conditions
                          updated_at: '2024-08-14T11:57:47'
                          usecase: 2FA
                          phone_numbers:
                            - '14358684439'
                            - '13193337776'
                            - '12673296046'
                      pagination:
                        current_page: 1
                        per_page: 25
                        total: 1
                        total_pages: 1
              examples:
                default:
                  value:
                    items:
                      - affiliate_marketing: false
                        age_gated: false
                        auto_renewal: false
                        brand_id: BM20QP9
                        campaign_id: CKLCK95
                        created_at: '2024-08-14T11:57:41'
                        description: Our campaign aims to …
                        direct_lending: false
                        embedded_link_sample: null
                        embedded_links: false
                        embedded_phones: false
                        feedback: null
                        help: true
                        help_keywords: help
                        help_message: >-
                          For help, please visit www.site.com. To opt-out, reply
                          STOP.
                        last_bill_date: '2024-08-14T11:57:42'
                        mock: false
                        monthly_fee: '10.0'
                        name: My first campaign
                        next_bill_date: '2024-11-14T00:00:00'
                        optin: true
                        optin_keywords: begin,start
                        optin_message: >-
                          You are now opted-in for help please reply HELP, to
                          stop please reply STOP
                        optin_workflow: Our SMS ...
                        optout: true
                        optout_keywords: stop,quit,unsubscribe
                        optout_message: >-
                          You are now opted out and will receive no further
                          messages
                        privacy_policy: https://site.com/privacy-policy
                        sample1: Your verification code is XXXXXX
                        sample2: XXXX is your verification code
                        sample3: null
                        sample4: null
                        sample5: null
                        status: APPROVED
                        terms_conditions: https://site.com/terms-and-conditions
                        updated_at: '2024-08-14T11:57:47'
                        usecase: 2FA
                        phone_numbers:
                          - '14358684439'
                          - '13193337776'
                          - '12673296046'
                    pagination:
                      current_page: 1
                      per_page: 25
                      total: 1
                      total_pages: 1
        '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:
    TenDLCCampaignListResponse:
      title: TenDLCCampaignListResponse
      required:
        - items
        - pagination
      type: object
      additionalProperties: false
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/TenDLCCampaign'
          description: 10DLC Campaigns on the current page that match the filter criteria.
        pagination:
          allOf:
            - $ref: '#/components/schemas/Pagination'
            - description: Pagination metadata for the result set.
      description: Paginated list of 10DLC Campaigns.
      example:
        items:
          - affiliate_marketing: false
            age_gated: false
            auto_renewal: false
            brand_id: BM20QP9
            campaign_id: CKLCK95
            created_at: '2024-08-14T11:57:41'
            description: Our campaign aims to …
            direct_lending: false
            embedded_link_sample: null
            embedded_links: false
            embedded_phones: false
            feedback: null
            help: true
            help_keywords: help
            help_message: For help, please visit www.site.com. To opt-out, reply STOP.
            last_bill_date: '2024-08-14T11:57:42'
            mock: false
            monthly_fee: '10.0'
            name: My first campaign
            next_bill_date: '2024-11-14T00:00:00'
            optin: true
            optin_keywords: begin,start
            optin_message: >-
              You are now opted-in for help please reply HELP, to stop please
              reply STOP
            optin_workflow: Our SMS ...
            optout: true
            optout_keywords: stop,quit,unsubscribe
            optout_message: You are now opted out and will receive no further messages
            privacy_policy: https://site.com/privacy-policy
            sample1: Your verification code is XXXXXX
            sample2: XXXX is your verification code
            sample3: null
            sample4: null
            sample5: null
            status: APPROVED
            terms_conditions: https://site.com/terms-and-conditions
            updated_at: '2024-08-14T11:57:47'
            usecase: 2FA
            phone_numbers:
              - '14358684439'
              - '13193337776'
              - '12673296046'
        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.
    TenDLCCampaign:
      title: TenDLCCampaign
      required:
        - affiliate_marketing
        - age_gated
        - auto_renewal
        - last_bill_date
        - next_bill_date
        - direct_lending
        - embedded_links
        - embedded_phones
        - embedded_link_sample
        - brand_id
        - campaign_id
        - description
        - optin_workflow
        - feedback
        - help
        - help_keywords
        - help_message
        - optin
        - optin_keywords
        - optin_message
        - optout
        - optout_keywords
        - optout_message
        - name
        - created_at
        - sample1
        - sample2
        - sample3
        - sample4
        - sample5
        - updated_at
        - mock
        - usecase
        - monthly_fee
        - terms_conditions
        - privacy_policy
        - status
        - phone_numbers
      type: object
      additionalProperties: false
      properties:
        affiliate_marketing:
          type: boolean
          description: Indicates whether the Campaign is used for affiliate marketing.
          example: false
        age_gated:
          type: boolean
          description: Indicates whether the Campaign messages contain age-gated content.
          example: false
        auto_renewal:
          type: boolean
          description: Indicates whether the Campaign should be automatically renewed.
          example: true
        last_bill_date:
          type:
            - string
            - 'null'
          description: >-
            Date and time the Campaign was last billed in ISO 8601 format.
            `null` if the Campaign has never been billed.
          example: '2024-08-14T11:57:42'
        next_bill_date:
          type:
            - string
            - 'null'
          description: >-
            Date and time the Campaign will be billed next in ISO 8601 format.
            `null` if the next billing date is not scheduled.
          example: '2024-08-14T11:57:42'
        direct_lending:
          type: boolean
          description: >-
            Indicates whether the Campaign messages contain direct lending
            content.
          example: true
        embedded_links:
          type: boolean
          description: Indicates whether the Campaign messages contain embedded links.
          example: true
        embedded_phones:
          type: boolean
          description: >-
            Indicates whether the Campaign messages contain embedded phone
            numbers.
          example: true
        embedded_link_sample:
          type:
            - string
            - 'null'
          description: Sample of an embedded link used in Campaign messages.
        brand_id:
          type: string
          description: Unique identifier of the Brand that owns the Campaign.
          example: BM20QP9
        campaign_id:
          type: string
          description: Unique identifier of the Campaign assigned by the registry.
          example: CKLCK95
        description:
          type:
            - string
            - 'null'
          description: Description of the Campaign and its messaging purpose.
          example: Our campaign aims to …
        optin_workflow:
          type:
            - string
            - 'null'
          description: >-
            Description of the workflow through which subscribers opt in to the
            Campaign.
          example: Our SMS ...
        feedback:
          type:
            - string
            - 'null'
          description: Feedback from the registry explaining the current `status`.
        help:
          type: boolean
          description: >-
            Indicates whether the campaign includes a help system (for example,
            keyword: HELP, INFO).
          example: true
        help_keywords:
          type: string
          description: >-
            Comma-separated list of help keywords. Keywords are
            case-insensitive.
          example: help
        help_message:
          type:
            - string
            - 'null'
          description: Help message sent upon receiving a help keyword.
          example: For help, please visit www.site.com. To opt out, reply STOP.
        optin:
          type: boolean
          description: Indicates whether the Campaign requires subscriber opt-in.
          example: true
        optin_keywords:
          type: string
          description: >-
            Comma-separated list of opt-in keywords. Keywords are
            case-insensitive.
          example: begin,start
        optin_message:
          type:
            - string
            - 'null'
          description: Opt-in message sent upon receiving an opt-in keyword.
          example: >-
            You are now opted-in for help please reply HELP, to stop please
            reply STOP
        optout:
          type: boolean
          description: >-
            Indicates whether the campaign includes an opt-out system (for
            example, keyword: STOP, QUIT).
          example: true
        optout_keywords:
          type: string
          description: >-
            Comma-separated list of opt-out keywords. Keywords are
            case-insensitive.
          example: stop,quit,unsubscribe
        optout_message:
          type:
            - string
            - 'null'
          description: Opt-out message sent upon receiving an opt-out keyword.
          example: You are now opted out and will receive no further messages
        name:
          type: string
          description: Display name of the Campaign.
          example: My first campaign
        created_at:
          type: string
          description: Timestamp when the Campaign was created, in ISO 8601 format.
          example: '2024-08-14T11:57:41'
        sample1:
          type:
            - string
            - 'null'
          description: Sample message demonstrating the content sent through the Campaign.
          example: Your verification code is XXXXXX
        sample2:
          type:
            - string
            - 'null'
          description: Sample message demonstrating the content sent through the Campaign.
        sample3:
          type:
            - string
            - 'null'
          description: Sample message demonstrating the content sent through the Campaign.
        sample4:
          type:
            - string
            - 'null'
          description: Sample message demonstrating the content sent through the Campaign.
        sample5:
          type:
            - string
            - 'null'
          description: Sample message demonstrating the content sent through the Campaign.
        updated_at:
          type: string
          description: Timestamp when the Campaign was last updated, in ISO 8601 format.
          example: '2024-08-14T11:57:47'
        mock:
          type: boolean
          description: >-
            Indicates whether the Campaign is a mock campaign used for testing.
            Mock campaigns cannot send production traffic.
          example: false
        usecase:
          type: string
          description: Registered use case for the Campaign, such as `2FA` or `MARKETING`.
          example: 2FA
        monthly_fee:
          type: string
          description: Recurring monthly fee charged for the Campaign, as a decimal string.
          example: '10.0'
        privacy_policy:
          type:
            - string
            - 'null'
          description: Privacy policy URL.
          example: https://site.com/privacy-policy
        terms_conditions:
          type:
            - string
            - 'null'
          description: Terms and conditions URL.
          example: https://site.com/terms-and-conditions
        status:
          type: string
          description: >-
            Current registration status of the Campaign, such as `APPROVED` or
            `PENDING`.
          example: APPROVED
        phone_numbers:
          type: array
          items:
            type: string
          description: Phone numbers assigned to the Campaign, in E.164 format.
          example:
            - '14358684439'
            - '13193337776'
            - '12673296046'
      description: >-
        Represents a 10DLC campaign registered under a Brand. A Campaign defines
        the messaging use case, opt-in and opt-out flows, and the phone numbers
        permitted to send its traffic.
      example:
        affiliate_marketing: false
        age_gated: false
        auto_renewal: false
        brand_id: BM20QP9
        campaign_id: CKLCK95
        created_at: '2024-08-14T11:57:41'
        description: Our campaign aims to …
        direct_lending: false
        embedded_link_sample: null
        embedded_links: false
        embedded_phones: false
        feedback: null
        help: true
        help_keywords: help
        help_message: For help, please visit www.site.com. To opt-out, reply STOP.
        last_bill_date: '2024-08-14T11:57:42'
        mock: false
        monthly_fee: '10.0'
        name: My first campaign
        next_bill_date: '2024-11-14T00:00:00'
        optin: true
        optin_keywords: begin,start
        optin_message: >-
          You are now opted-in for help please reply HELP, to stop please reply
          STOP
        optin_workflow: Our SMS ...
        optout: true
        optout_keywords: stop,quit,unsubscribe
        optout_message: You are now opted out and will receive no further messages
        privacy_policy: https://site.com/privacy-policy
        sample1: Your verification code is XXXXXX
        sample2: XXXX is your verification code
        sample3: null
        sample4: null
        sample5: null
        status: APPROVED
        terms_conditions: https://site.com/terms-and-conditions
        updated_at: '2024-08-14T11:57:47'
        usecase: 2FA
        phone_numbers:
          - '14358684439'
          - '13193337776'
          - '12673296046'
    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
  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).

````