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

# Request external vetting

> Requests external vetting for a 10DLC Brand. Supported providers: `AEGIS`, `CV`, `WMC`. Supported classes: `STANDARD`, `ENHANCED`.



## OpenAPI

````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml post /v3/10dlc/brands/{brand_id}/vettings
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}/vettings:
    post:
      tags:
        - 10DLC
      summary: Request external vetting
      description: >-
        Requests external vetting for a 10DLC Brand. Supported providers:
        `AEGIS`, `CV`, `WMC`. Supported classes: `STANDARD`, `ENHANCED`.
      operationId: ten_dlc_brand_vettings_create
      parameters:
        - name: brand_id
          in: path
          description: The unique ID of the 10DLC Brand.
          required: true
          style: simple
          schema:
            type: string
            example: B6AI7PA
      requestBody:
        description: Provider and class for the external vetting.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TenDLCBrandVettingCreateRequest'
        required: true
      responses:
        '200':
          description: Returns the requested external vetting.
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TenDLCBrandVetting'
              examples:
                success:
                  summary: Successful response
                  value:
                    evp_id: AEGIS
                    create_date: '2024-08-01T14:09:43'
                    vetting_details:
                      additional_prop1: {}
                      additional_prop2: {}
                      additional_prop3: {}
                    vetted_date: '2024-08-01T14:09:43'
                    vetting_id: 13d8e00c-3cb4-4dc0-9e26-d5057fa938d9
                    vetting_token: >-
                      3oDcE1vq8OR43claMa6Thu/7V4vzZywAfKRgiJnXDjlw+08wpWbGqOssAXKgeZibHCLaGgXvU/yPb7kISeeb5qGdisGRLdhPnSNpvRR82RnCWYNpTp92orlJWjTJU8ZGmNxL5MwK0tt/9SxCha36iTtPV2+4vND8xCPe5suItuQTonG4A3Yi6F1LMqihgwdesRjxJnKqcE7Thcv9ug1NyNPYEZQvPugFj2F2DdU6jFZcOWgXsnE7ucZ+xNaNX9LkF9if3v0hrcviG9L8bUUrpPBGr02txP0i+cPBTLbj4Rq1Ox83R+WUx1gnoXHCIU1ByDGWvQq2Ef4qxGVOwPJHJbja1BovxKBk4YJxiz8OSO68QAIEfxuPTpj5eZz7KEFtFmBIVaVmxBDe4b8Tpl01C2rek7xgPzXaoURvh7CQVnVmJL00DTWKvyOmUOQQW901XEcgcJ7VWgfIvxhIMuXEXXtVDGNowmEc9JQXXYHVlGuN5QicSbApkwwqRZI7TQ4lsS66zCfqomIIJyBNRJpl+8sGwsa2J2h6fEkAD77J9zdUgIKXMFamHbvRadCKMZNIbMrkOC7PuOjZdSiWKh5A8FSjzkv3PlN2hRDqkaODEoodp5pTQeBtNe37+uAMOuHNfsZXlwvfMgCZjiZJ9HQNSLhJBUq7/IvT/EzszUk4HPTj/WFSbT1YrrkDi+zrB20ZDY9lZFWxN1hlYQoNcanDAAWPmw/yW1+8DroL5WIMGsXX3WFGOG7eWB1GHgFQsziAeRQl78u1qOvsRMN08+GrkASBJwqwy5l7xCesUKqbz3O0QA/dwzzsWIDvFPavZpjqMBSjRTurQLFahAaGmdY0BX/Ii+s2+OxfaHQIa1lgucm0P7GPKeZvLX/8boO01Onr/87ra+NX7ABvQb+SXvwsg+Bm5CziWB6DMKDKRD/KQjHxpjIY35UwSEW7G4ixux7ufizXttthHfPJWd/rWFhfYigFhVLgIPCR12smwFVuZwM7ujvY2CIM0X4E0dsX9uVHkgYmqRIdNf5vshpmRuIcHsXZpTJP/tD7zQM6m214c5xkJSfAVIaD7WzRYS4eVL+R3z4u+6n5p6FjuWSjSzuEffUai3HCWjes4JbtDSjIwoG0tOMtBukgPbreH+pjXcvnhU+1QhCV2aIdG6C3FmaI5Uoo/mthJyiFAThwtOpxQ5YkdsRunqVVEFYZfMNEn4Ig2clCFrLOm46JB2wPcLGP2MoH5RqajYzQ6IV8IXIFQVzG0C7HoHsBkVp+GrpnH6N0FCKR+fpbGjigM2lLf4pYBhChUY4ao9hvV1hd8ikS6QoasvDLPytBBa1YAwbSa8d7YdwO6fXfQqetfS8S9gbHD0zxazw5p9Lp5fXFmajDNkD2voYNMzOHJMMHG/49pWV2
                    vetting_score: 80
                    vetting_class: STANDARD
                    vetting_status: PENDING
                    reasons:
                      - >-
                        Company size as reported by government or business
                        sources resulted in a score deduction: size range 6-10
        '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:write
components:
  schemas:
    TenDLCBrandVettingCreateRequest:
      title: TenDLCBrandVettingCreateRequest
      required:
        - evp_id
        - vetting_class
      type: object
      additionalProperties: false
      properties:
        evp_id:
          type: string
          description: >-
            Code identifying the external vetting provider to perform the
            vetting.
          example: AEGIS
        vetting_class:
          type: string
          description: Class of vetting to request, such as `STANDARD` or `ENHANCED`.
          example: STANDARD
    TenDLCBrandVetting:
      title: TenDLCBrandVetting
      description: >-
        Represents the result of an external vetting performed on a 10DLC brand.
        Vetting can raise a Brand's trust score and unlock higher messaging
        throughput.
      required:
        - evp_id
        - create_date
        - vetted_date
        - vetting_id
        - vetting_token
        - vetting_score
        - vetting_class
        - vetting_status
        - reasons
      type: object
      additionalProperties: false
      properties:
        evp_id:
          type: string
          description: >-
            Code identifying the external vetting provider that performed the
            vetting.
          example: AEGIS
        create_date:
          type: string
          description: Timestamp when the vetting request was created, in ISO 8601 format.
          example: '2024-08-01T14:09:43'
        vetting_details:
          type: object
          description: Additional provider-specific details about the vetting request.
          additionalProperties: true
          example:
            additional_prop1: {}
            additional_prop2: {}
            additional_prop3: {}
        vetted_date:
          type:
            - string
            - 'null'
          description: >-
            Timestamp when the vetting was completed, in ISO 8601 format. Null
            while the vetting is still in progress.
          example: '2024-08-01T14:09:43'
        vetting_id:
          type: string
          description: Unique identifier of the vetting request.
          example: 13d8e00c-3cb4-4dc0-9e26-d5057fa938d9
        vetting_token:
          type:
            - string
            - 'null'
          description: >-
            Token issued by the vetting provider that uniquely identifies this
            vetting result.
          example: >-
            3oDcE1vq8OR43claMa6Thu/7V4vzZywAfKRgiJnXDjlw+08wpWbGqOssAXKgeZibHCLaGgXvU/yPb7kISeeb5qGdisGRLdhPnSNpvRR82RnCWYNpTp92orlJWjTJU8ZGmNxL5MwK0tt/9SxCha36iTtPV2+4vND8xCPe5suItuQTonG4A3Yi6F1LMqihgwdesRjxJnKqcE7Thcv9ug1NyNPYEZQvPugFj2F2DdU6jFZcOWgXsnE7ucZ+xNaNX9LkF9if3v0hrcviG9L8bUUrpPBGr02txP0i+cPBTLbj4Rq1Ox83R+WUx1gnoXHCIU1ByDGWvQq2Ef4qxGVOwPJHJbja1BovxKBk4YJxiz8OSO68QAIEfxuPTpj5eZz7KEFtFmBIVaVmxBDe4b8Tpl01C2rek7xgPzXaoURvh7CQVnVmJL00DTWKvyOmUOQQW901XEcgcJ7VWgfIvxhIMuXEXXtVDGNowmEc9JQXXYHVlGuN5QicSbApkwwqRZI7TQ4lsS66zCfqomIIJyBNRJpl+8sGwsa2J2h6fEkAD77J9zdUgIKXMFamHbvRadCKMZNIbMrkOC7PuOjZdSiWKh5A8FSjzkv3PlN2hRDqkaODEoodp5pTQeBtNe37+uAMOuHNfsZXlwvfMgCZjiZJ9HQNSLhJBUq7/IvT/EzszUk4HPTj/WFSbT1YrrkDi+zrB20ZDY9lZFWxN1hlYQoNcanDAAWPmw/yW1+8DroL5WIMGsXX3WFGOG7eWB1GHgFQsziAeRQl78u1qOvsRMN08+GrkASBJwqwy5l7xCesUKqbz3O0QA/dwzzsWIDvFPavZpjqMBSjRTurQLFahAaGmdY0BX/Ii+s2+OxfaHQIa1lgucm0P7GPKeZvLX/8boO01Onr/87ra+NX7ABvQb+SXvwsg+Bm5CziWB6DMKDKRD/KQjHxpjIY35UwSEW7G4ixux7ufizXttthHfPJWd/rWFhfYigFhVLgIPCR12smwFVuZwM7ujvY2CIM0X4E0dsX9uVHkgYmqRIdNf5vshpmRuIcHsXZpTJP/tD7zQM6m214c5xkJSfAVIaD7WzRYS4eVL+R3z4u+6n5p6FjuWSjSzuEffUai3HCWjes4JbtDSjIwoG0tOMtBukgPbreH+pjXcvnhU+1QhCV2aIdG6C3FmaI5Uoo/mthJyiFAThwtOpxQ5YkdsRunqVVEFYZfMNEn4Ig2clCFrLOm46JB2wPcLGP2MoH5RqajYzQ6IV8IXIFQVzG0C7HoHsBkVp+GrpnH6N0FCKR+fpbGjigM2lLf4pYBhChUY4ao9hvV1hd8ikS6QoasvDLPytBBa1YAwbSa8d7YdwO6fXfQqetfS8S9gbHD0zxazw5p9Lp5fXFmajDNkD2voYNMzOHJMMHG/49pWV2
        vetting_score:
          type:
            - integer
            - 'null'
          description: >-
            Score assigned to the Brand by the vetting provider. Null until
            vetting completes.
          format: int32
          example: 80
        vetting_class:
          type: string
          description: Class of vetting performed, such as `STANDARD` or `ENHANCED`.
          example: STANDARD
        vetting_status:
          type: string
          description: >-
            Current status of the vetting request, such as `PENDING` or
            `ACTIVE`.
          example: PENDING
        reasons:
          type:
            - array
            - 'null'
          description: >-
            Reasons explaining the assigned `vetting_score`. Null when no
            reasons are provided.
          items:
            type: string
          example:
            - >-
              Company size as reported by government or business sources
              resulted in a score deduction: size range 6-10
    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.
    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
  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).

````