Vet a brand
Requests an external vet of a registered brand from the US 10DLC registry. A successful vet can raise the brand’s trust tier and, with it, the throughput carriers grant its campaigns.
curl --request POST \
--url https://api.vobiz.ai/api/v1/sms/10dlc/brands/{id}/vet \
--header 'Content-Type: application/json' \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>' \
--data '
{
"type": "STANDARD"
}
'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.brands.vet_brand(
id="8e6c4a2f-0d9b-4b7a-a5c3-1e9f7d5b3a10",
type="STANDARD",
)
const options = {
method: 'POST',
headers: {
'X-Auth-ID': '<api-key>',
'X-Auth-Token': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({type: 'STANDARD'})
};
fetch('https://api.vobiz.ai/api/v1/sms/10dlc/brands/{id}/vet', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"vettingId": "4b3a2c1d-0e9f-4a8b-9c7d-6e5f4a3b2c1d",
"vettingClass": "STANDARD",
"vettingStatus": "PENDING",
"createDate": "2026-10-12T11:10:00Z"
}{
"error": "invalid request: type must be one of STANDARD, ENHANCED, POLITICAL"
}{
"error": "missing or invalid credentials"
}{
"error": "brand not found"
}{
"error": "registration provider rejected the request: brand must be registered before vetting",
"providerError": "registration error 403 (HTTP 403): brand must be registered"
}{
"error": "internal error"
}{
"error": "registration provider unavailable",
"providerError": "registration error 500 (HTTP 500): upstream timeout"
}Authorizations
Your Vobiz account Auth ID (MA_XXXXXXXX).
Your Vobiz account Auth Token.
Path Parameters
Brand ID (UUID) returned by POST /10dlc/brands. An unknown ID, an ID from another account, or a value that is not a UUID returns 404 with {"error":"brand not found"}.
Body
Body of a brand vetting request. Send {} or omit type for a standard vet.
Kind of vet to request: STANDARD (the default), ENHANCED (a deeper review) or POLITICAL (for political organisations). Case-insensitive; any other value returns 400 with invalid request: type must be one of STANDARD, ENHANCED, POLITICAL.
STANDARD, ENHANCED, POLITICAL Response
The registry's vetting record. Keys follow the registry's schema.
A record returned by the US 10DLC registry, such as a vetting record, passed through as received. Its keys follow the registry's schema, so read the fields you need and ignore the rest.
Was this page helpful?
curl --request POST \
--url https://api.vobiz.ai/api/v1/sms/10dlc/brands/{id}/vet \
--header 'Content-Type: application/json' \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>' \
--data '
{
"type": "STANDARD"
}
'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.brands.vet_brand(
id="8e6c4a2f-0d9b-4b7a-a5c3-1e9f7d5b3a10",
type="STANDARD",
)
const options = {
method: 'POST',
headers: {
'X-Auth-ID': '<api-key>',
'X-Auth-Token': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({type: 'STANDARD'})
};
fetch('https://api.vobiz.ai/api/v1/sms/10dlc/brands/{id}/vet', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"vettingId": "4b3a2c1d-0e9f-4a8b-9c7d-6e5f4a3b2c1d",
"vettingClass": "STANDARD",
"vettingStatus": "PENDING",
"createDate": "2026-10-12T11:10:00Z"
}{
"error": "invalid request: type must be one of STANDARD, ENHANCED, POLITICAL"
}{
"error": "missing or invalid credentials"
}{
"error": "brand not found"
}{
"error": "registration provider rejected the request: brand must be registered before vetting",
"providerError": "registration error 403 (HTTP 403): brand must be registered"
}{
"error": "internal error"
}{
"error": "registration provider unavailable",
"providerError": "registration error 500 (HTTP 500): upstream timeout"
}