> ## 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 Brand identity appeals

> Returns the identity verification appeals submitted for the 10DLC Brand identified by `brand_id`.



## OpenAPI

````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml get /v3/10dlc/brands/{brand_id}/appeals
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/{brand_id}/appeals:
    get:
      tags:
        - 10DLC
      summary: List Brand identity appeals
      description: >-
        Returns the identity verification appeals submitted for the 10DLC Brand
        identified by `brand_id`.
      operationId: ten_dlc_brand_appeals_list
      parameters:
        - name: brand_id
          in: path
          description: The unique ID of the 10DLC Brand.
          required: true
          style: simple
          schema:
            type: string
            example: BM20QP9
      responses:
        '200':
          description: Returns the list of identity verification appeals.
          headers: {}
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TenDLCBrandAppeal'
                example:
                  - categories:
                      - VERIFY_TAX_ID
                    created_at: '2024-08-01T14:09:43Z'
                    evidence: []
                    explanation: Dear partner, please review the registration docs
                    outcome:
                      optional_attributes: {}
                      feedback:
                        category: []
                      vetting_status: VERIFIED
                    status: COMPLETE
                    updated_at: '2024-08-01T18:33:15Z'
              examples:
                default:
                  value:
                    - categories:
                        - VERIFY_TAX_ID
                      created_at: '2024-08-01T14:09:43Z'
                      evidence: []
                      explanation: Dear partner, please review the registration docs
                      outcome:
                        optional_attributes: {}
                        feedback:
                          category: []
                        vetting_status: VERIFIED
                      status: COMPLETE
                      updated_at: '2024-08-01T18:33:15Z'
        '400':
          description: Returns a validation error when a field value is invalid.
          headers: {}
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/RecordNotFoundErrorResponse'
                  - example:
                      success: false
                      message: Invalid Request
              examples:
                success:
                  summary: Successful response
                  value:
                    success: false
                    message: Invalid Request
        '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.
        '404':
          description: Returns when the requested 10DLC resource does not exist.
          headers: {}
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/RecordNotFoundErrorResponse'
                  - example:
                      success: false
                      message: Request failed. The Brand is not found.
              examples:
                success:
                  summary: Successful response
                  value:
                    success: false
                    message: Request failed. The Brand is not found.
      deprecated: false
      security:
        - bearerAuth:
            - campaigns:read
components:
  schemas:
    TenDLCBrandAppeal:
      title: TenDLCBrandAppeal
      required:
        - categories
        - created_at
        - evidence
        - outcome
        - status
        - updated_at
        - explanation
      type: object
      additionalProperties: false
      properties:
        categories:
          type: array
          items:
            type: string
          description: >-
            A list of Brand Identity status appeal categories associated with
            the original request
          example:
            - VERIFY_TAX_ID
        created_at:
          type: string
          description: The date and time the appeal request is created
          format: date-time
          example: '2024-08-01T14:09:43Z'
        evidence:
          type: array
          items:
            type: string
          description: A list of evidence UUIDs to be associated with the appeal
          example:
            - 13d8e00c-3cb4-4dc0-9e26-d5057fa938d9
        outcome:
          allOf:
            - $ref: '#/components/schemas/TenDLCBrandAppealOutcome'
            - description: The appeal outcome details
        status:
          type: string
          description: The appeal status
          example: COMPLETED
        updated_at:
          type: string
          description: The date and time the appeal request is updated
          format: date-time
          example: '2024-08-01T14:09:43Z'
        explanation:
          type: string
          description: The appeal justification
          example: Dear partner, please review the uploaded company registration docs.
      example:
        categories:
          - VERIFY_TAX_ID
        created_at: '2024-08-01T14:09:43Z'
        evidence: []
        explanation: Dear partner, please review the registration docs
        outcome:
          optional_attributes: {}
          feedback:
            category: []
          vetting_status: VERIFIED
        status: COMPLETE
        updated_at: '2024-08-01T18:33:15Z'
    RecordNotFoundErrorResponse:
      title: RecordNotFoundErrorResponse
      required:
        - success
        - message
      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 error description
          example: Record not found
      example:
        success: false
        message: Record not found
    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.
    TenDLCBrandAppealOutcome:
      title: TenDLCBrandAppealOutcome
      required:
        - optional_attributes
        - vetting_status
        - feedback
      type: object
      additionalProperties: false
      properties:
        optional_attributes:
          type: object
          additionalProperties: false
          description: An optional attributes that might be returned from TCR
        vetting_status:
          allOf:
            - $ref: '#/components/schemas/TenDLCBrandIdentityVerificationStatus'
            - description: Brand Identity Verification appeal outcome
              example: UNVERIFIED
        feedback:
          allOf:
            - $ref: '#/components/schemas/TCRFeedback'
            - description: Brand Identity Verification appeal feedback, if any
    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.
    TCRFeedback:
      title: TCRFeedback
      required:
        - category
      type: object
      additionalProperties: false
      properties:
        category:
          type: array
          items:
            $ref: '#/components/schemas/TCRFeedbackCategory'
          description: The feedback category
    TCRFeedbackCategory:
      title: TCRFeedbackCategory
      required:
        - id
        - display_name
        - description
        - fields
        - errors
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          description: The submitted appeal category
          example: VERIFY_TAX_ID
        display_name:
          type: string
          description: The display name of the category
          example: Verify tax ID
        description:
          type: string
          description: The description of the category
          example: >-
            Select this category if the record is UNVERIFIED due to an inability
            to match the tax ID.
        fields:
          type:
            - string
            - 'null'
          description: An array of Brand attributes
        errors:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/TCRErrorMessage'
          description: An array of verification errors, if any
      description: TCR returns the feedback per submitted appeal category
    TCRErrorMessage:
      title: TCRErrorMessage
      required:
        - code
        - message
      type: object
      additionalProperties: false
      properties:
        code:
          type: string
          description: TCR error code
        message:
          type: string
          description: A human-readable error description
      example:
        code: TFTI01
        message: The submitted US EIN is invalid.
  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).

````