Create 10DLC Brand Vetting
Submit a 10DLC brand for external vetting.
curl https://v1.api19.com/campaigns/brand/vetting/create \
-d 'key=api_token' \
-d 'brand_id=B1A2C3D4E5' \
-d 'evpId=EVP001' \
-d 'vettingClass=STANDARD'{
"status": "ok",
"data": {
"evpId": "AEGIS",
"vettingId": "###",
"vettingToken": "###",
"vettingScore": null,
"vettingClass": "STANDARD",
"vettingStatus": "PENDING",
"reasons": null,
"vettingDetails": {},
"vettedDate": null,
"createDate": "2025-02-07T17:26:11.539Z"
"validUntil": null,
"expirationDate": null
}
}Parameters
brand_id(required) - Brand IDevpId(required) - External vetting provider IDvettingClass(required) - Vetting class typeadditionalRequestPayload(optional) - Additional data required by the vetting provider
Developer Guide
External Vets for SOLE_PROPRIETORS and PUBLIC_PROFITS
Some brand entity types have restrictions that can prohibit an external vetting request, or require that the brand have a specific identity status before the request is processed.
SOLE_PROPRIETOR: A brand with this entity type cannot request external vetting.
PUBLIC_PROFIT: A Public Profit brand must have a
VERIFIEDorVETTED_VERIFIEDidentity status in order to qualify for a new external vet or to import an external vet.
Vetting Providers and Supported Vetting Classes
Some vetting providers only accept requests for specific types of vets (referred to as a vetting class). Additionally, certain vets are limited to a brand's national origin and entity type. The following table provides information on external vetting providers and the types of vets they accept.
Aegis Mobile
AEGIS
STANDARD
Requests a standard external vet. Allowed for US and non-US brands. Eligible Entity Types: • PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, GOVERNMENT
AEGIS
POLITICAL
Requests a political external vet. Allowed for US brands only. Eligible Entity Types: • NON_PROFIT
AEGIS
ENHANCED
Requests an enhanced external vet. Allowed for US and non-US brands. Eligible Entity Types: • PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, GOVERNMENT
AEGIS
AUTHPLUS
Requests an Authentication+ verification. Allowed for US and non-US brands. Eligible Entity Types: • PUBLIC_PROFIT
AEGIS
RBM
Requests an RBM verification. Allowed for US and non-US brands. Completing an RBM vet automatically grants Auth+ compliance to a brand. Eligible Entity Types: • PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT, GOVERNMENT
WMC Global
WMC
STANDARD
Requests a standard external vet. Allowed for US brands only. Eligible Entity Types: • PRIVATE_PROFIT, PUBLIC_PROFIT
WMC
POLITICAL
Not supported.
WMC
ENHANCED
Not supported.
WMC
AUTHPLUS
Not supported.
WMC
RBM
Not supported.
Requesting an External Vet
All vets are requested by using the POST /campaigns/brand/vetting/create endpoint. The JSON request body must contain a valid evpId, which is the identity of the external vetting provider (see table above), and a vettingClass. Supported vetting classes include STANDARD, ENHANCED, POLITICAL, AUTHPLUS, and RBM.
Standard Vet
Standard vets can be used to verify a brand or potentially gain access to better throughput levels with network carriers. A Standard vet is an automated review of compliance history, employee count, and other business metrics. Once complete, a score of 0-100 will be provided to determine the brand's throughput level for particular carriers. Scores grant different terms per carrier, and feedback reasons are provided.
Standard vets can be requested through the API without the optional additionalRequestPayload parameter.
Example Request
Example Response
Enhanced Vet
Enhanced vets are typically requested if a user is dissatisfied with their Standard vet score. If a CSP has already submitted a Standard vet appeal and believes a more thorough review would yield a higher score, they can order an Enhanced vet.
Enhanced vets can be requested through the API without the optional additionalRequestPayload parameter.
Example Request
Example Response
Political Vet
Political vets allow brands to use the Political special use case. NON_PROFIT brands that have a 501(c)(3/4/5/6) Tax Exempt Status are already granted access to the Political use case and are not allowed to request or import a Political vet from any vendor.
A request body parameter additionalRequestPayload is required when requesting Political vets. It's used to provide additional brand information that's required by vetting providers to successfully process the vetting request. Information on these fields can be found in Appendix A: Additional Payload Request Schema.
Example Request
Example Response
Auth+ Vet
Auth+ vets verify a brand's business contact through a Two-Factor Authentication (2FA) email process. They are only available for PUBLIC_PROFIT brands and are required for those brands to create new campaigns. For more information, see the Authentication+ 2.0 Feature Overview.
Auth+ vets can be requested through the API without the optional additionalRequestPayload parameter.
Example Request
Example Response
RBM Vet
RBM vets verify a brand's eligibility for RCS Business Messaging (RBM) as well as a business contact through a Two-Factor Authentication (2FA) email process. They are available for all entity types except SOLE_PROPRIETOR and are not tied to a brand's identity status (i.e., a brand can be VERIFIED or UNVERIFIED). Successfully completing an RBM vet automatically grants Authentication+ compliance without completing an Auth+ vet. For more information, see the RBM Vetting Feature Overview.
RBM vets can be requested through the API without the optional additionalRequestPayload parameter.
Example Request
Example Response
Appendix A: Additional Payload Request Schema
requestorFirstName
String
Yes
First name of the committee person who initiated the verification request. Must be an exact match with what is filed with the election authority. Max Length: 100
requestorLastName
String
Yes
Last name of the committee person who initiated the verification request. Must be an exact match with what is filed with the election authority. Max Length: 100
locale
String
Yes
Accepted values: Federal, State, Local, Tribal Max Length: 16
fecCommitteeTypeCode
String
See description
Required if Federal. Refer to Appendix C: Committee Type Codes for a list of acceptable values. Max Length: 1
committeeId
String
Yes
The issued committee/campaign ID from the election authority. If the election authority does not require a committee/campaign ID for the specified locale, enter 00000. Max Length: 32
candidateType
String
Yes
Required for candidate campaigns. If the committee is not candidate-specific, enter PAC. Max Length: 64
stateLocalCommitteeType
String
Yes
Required for State, Local, and Tribal locales. If Federal, enter FEDERAL. Max Length: 64
localCommitteeState
String
Yes
If Federal Congress, enter the state to be represented. Refer to Appendix B: FEC Jurisdictions for acceptable values. If the election is for the US President, enter US. Max Length: 32
localCommitteeMunicipality
String
Yes
If Federal Congress, enter the district to be represented. If this is a presidential election, enter US. Max Length: 64
tribalLocation
String
Yes
If the locale is not Tribal, enter US. Max Length: 64
filingUrl
String
Yes
The election authority website URL. This website should contain filing information. Max Length: 256
filingRecordUrlInstructions
String
No
Additional instructions that provide information on how to locate the filing record. Max Length: 256
filingEmail
String
No
The email address filed with the election authority. Must be an exact match. If not supplied, the Political vet's PIN cannot be sent via email. Max Length: 128
electionDate
Date
Yes
The date of the election in the format yyyy-mm-dd. Must be a future date. Max Length: 10
pinPreference
String
Yes
Indicates how to deliver the Political vet's PIN. Accepted values are: Regular, Express, Email. Max Length: 16
Appendix B: FEC Jurisdictions
Alabama
AL
Alaska
AK
Arizona
AZ
Arkansas
AR
California
CA
Colorado
CO
Connecticut
CT
Delaware
DE
Florida
FL
Georgia
GA
Hawaii
HI
Idaho
ID
Illinois
IL
Indiana
IN
Iowa
IA
Kansas
KS
Kentucky
KY
Louisiana
LA
Maine
ME
Maryland
MD
Massachusetts
MA
Michigan
MI
Minnesota
MN
Mississippi
MS
Missouri
MO
Montana
MT
Nebraska
NE
Nevada
NV
New Hampshire
NH
New Jersey
NJ
New Mexico
NM
New York
NY
North Carolina
NC
North Dakota
ND
Ohio
OH
Oklahoma
OK
Oregon
OR
Pennsylvania
PA
Rhode Island
RI
South Carolina
SC
South Dakota
SD
Tennessee
TN
Texas
TX
Utah
UT
Vermont
VT
Virginia
VA
Washington
WA
West Virginia
WV
Wisconsin
WI
Wyoming
WY
District of Columbia
DC
American Samoa
AS
Guam
GU
Northern Mariana Islands
MP
Puerto Rico
PR
US Virgin Islands
VI
United States
US
Appendix C: Committee Type Codes
This information is reprinted from the Federal Election Commission website.
C
Communication cost
Organizations like corporations or unions may prepare communications for their employees or members that advocate the election of specific candidates and they must disclose them under certain circumstances. These are usually paid with direct corporate or union funds rather than from PACs.
D
Delegate committee
Delegate committees are organized for the purpose of influencing the selection of delegates to Presidential nominating conventions. The term includes a group of delegates, a group of individuals seeking to become delegates, and a group of individuals supporting delegates.
E
Electioneering communication
Groups (other than PACs) making electioneering communications.
H
House
Campaign committees for candidates for the U.S. House of Representatives.
I
Independent expenditor (person or group)
Individuals or groups (other than PACs) making independent expenditures over $250 in a year must disclose those expenditures.
N
PAC - Nonqualified
PACs that have not yet been in existence for six months and received contributions from 50 people and made contributions to five federal candidates. These committees have lower limits for their contributions to candidates.
O
Independent expenditure-only (Super PACs)
Political Committee that has filed a statement consistent with AO 2010-09 or AO 2010-11.
P
Presidential
Campaign committee for candidate for U.S. President.
Q
PAC - Qualified
PACs that have been in existence for six months and received contributions from 50 people and made contributions to five federal candidates.
S
Senate
Campaign committee for candidate for Senate.
U
Single-candidate independent expenditure
No description provided.
V
Hybrid PAC (with Non-Contribution Account) - Nonqualified
Political committees with non-contribution accounts.
W
Hybrid PAC with Non-Contribution Account - Qualified
Political committees with non-contribution accounts.
X
Party - Nonqualified
Party committees that have not yet been in existence for six months and received contributions from 50 people, unless they are affiliated with another party committee that has met these requirements.
Y
Party - Qualified
Party committees that have existed for at least six months and received contributions from 50 people or are affiliated with another party committee that meets these requirements.
Z
National party non-federal account
National party non-federal accounts. Not permitted after enactment of Bipartisan Campaign Reform Act of 2002.
Last updated