If a brand’s identity status comes back as UNVERIFIED, or if the brand is missing some essential optional attributes, CSPs can appeal or revet the brand to try and resolve the problem.
Performing an Identity Status Appeal
Appealing a brand’s identity status allows the CSP to add supporting documentation to prove that the brand is a legitimate business entity or should be granted a special optional attribute (such as a Tax Exempt status or Government Entity flag). CSPs can use the POST /brand/{brandId}/appeal endpoint to submit an appeal, but will need to provide an appeal category and should attach documentation to support their claim. For more information, see the Brand Vetting Appeals documentation.
Identity Status Appeal Request
POST /brand/{brandId}/appeal
curl -X 'POST' \
'https://csp-api-staging.campaignregistry.com/v2/brand/B123ABC/appeal' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"appealCategories": [
"LOW_SCORE"
],
"attachmentUuids": [
"B123ABC/VA/12345678901234567890123456789012"
],
"explanation": "Please see the attached documentation.",
"evpId": "AEGIS",
"vettingId": "###"
}'
Identity Status Appeal Response
204 Success
Revetting a Brand
Revetting a brand submits it again for an identity check. This should only be performed if there was missing or incorrect information supplied during brand registration (such as an incorrect company name or EIN) or if key brand information was updated after registration, resulting in the brand changing to an UNVERIFIED status. The CSP should update the brand’s information and submit it for revet using the PUT /brand/{brandId}/revet endpoint. If the CSP believes the supplied information is correct, but still received an UNVERIFIED status, they should perform an identity status appeal.
Revet Brand Request
PUT /brand/{brandId}/revet
curl -X 'PUT' \
'https://csp-api-staging.campaignregistry.com/v2/brand/B123ABC/revet' \
-H 'accept: application/json'
Revet Brand Response
{
"entityType": "PUBLIC_PROFIT",
"cspId": "S123ABC",
"brandId": "B123ABC",
"displayName": "ABC Mobile",
"companyName": "ABC Inc.",
"ein": "111111111",
"einIssuingCountry": "US",
"phone": "+15554567890",
"street": "123 6th Ave",
"city": "New York",
"state": "NY",
"postalCode": "10001",
"country": "US",
"email": "johndoe@abc.com",
"stockSymbol": "AAPL",
"stockExchange": "NASDAQ",
"website": "http://www.abcmobile.com",
"brandRelationship": "BASIC_ACCOUNT",
"vertical": "RETAIL",
"universalEin": "US_111111111",
"optionalAttributes": {},
"mock": false,
"identityStatus": "VERIFIED",
"createDate": "2025-02-07T17:29:17.000Z",
"businessContactTitle": "Marketing Coordinator",
"businessContactFirstName": "John",
"businessContactLastName": "Doe",
"businessContactEmail": "johndoe@abc.com",
"businessContactEmailVerifiedDate": "2025-02-07T17:29:19.000Z"
}