---
title: "Request external vetting"
method: POST
path: "/v3/10dlc/brands/{brand_id}/vettings"
tags: ["10DLC"]
---

# Request external vetting

`POST /v3/10dlc/brands/{brand_id}/vettings`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v3/10dlc/brands/{brand_id}/vettings`
- Auth: HTTP bearer

Requests external vetting for a 10DLC Brand. Supported providers: `AEGIS`, `CV`, `WMC`. Supported classes: `STANDARD`, `ENHANCED`. Charges a 10DLC brand vetting fee (Standard or Enhanced); fails with an insufficient-funds error when the balance cannot cover it.

## Path parameters

- `brand_id` string, required

## Request body

- TenDLCBrandVettingCreateRequest
  - `evp_id` string, required: Code identifying the external vetting provider to perform the vetting.
  - `vetting_class` string, required: Class of vetting to request, such as `STANDARD` or `ENHANCED`.

## Response `200`

Returns the requested external vetting.

- TenDLCBrandVetting: 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.
  - `evp_id` string, required: Code identifying the external vetting provider that performed the vetting.
  - `create_date` string, required: Timestamp when the vetting request was created, in ISO 8601 format.
  - `vetting_details` object: Additional provider-specific details about the vetting request.
  - `vetted_date` string, nullable, required: Timestamp when the vetting was completed, in ISO 8601 format. Null while the vetting is still in progress.
  - `vetting_id` string, required: Unique identifier of the vetting request.
  - `vetting_token` string, nullable, required: Token issued by the vetting provider that uniquely identifies this vetting result.
  - `vetting_score` integer, nullable, required: Score assigned to the Brand by the vetting provider. Null until vetting completes.
  - `vetting_class` string, required: Class of vetting performed, such as `STANDARD` or `ENHANCED`.
  - `vetting_status` string, required: Current status of the vetting request, such as `PENDING` or `ACTIVE`.
  - `reasons` string[], nullable, required: Reasons explaining the assigned `vetting_score`. Null when no reasons are provided.

## Other responses

- `400`: Request failed. Missing or invalid parameter <param_name>
- `401`: Unauthorized
- `403`: Returns when the 10DLC feature is disabled for the account.
- `404`: Returns when the requested 10DLC resource does not exist.
- `422`: Validation error

## Changes

- **2026-09-08** `6a89c962481c`: 2 breaking, 6 info
  - added the pattern `^B[A-Z0-9]{6}$` to the `path` request parameter `brand_id`
  - the response's body type changed from no type to `object` for status `404`
  - removed `#/components/schemas/RecordNotFoundErrorResponse, subschema #2` from the response body `allOf` list for the response status `404`
  - added the non-success response with the status `400`
  - …4 more
- **2026-05-25** `33be77905120`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-04-20** `2e48fd9894e1`: 3 info
  - api operation id `Requestexternalvettingfora10DLCBrand` removed and replaced with `ten_dlc_brand_vettings_create`
  - added `#/components/schemas/RecordNotFoundErrorResponse` to the response body `allOf` list for the response status `404`
  - removed `#/components/schemas/NotFoundException` from the response body `allOf` list for the response status `404`
- **2026-02-12** `fabaadf195a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v3/10dlc/brands/:brand_id/vettings/post.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) - [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/f2dde79f05ab?raw)