Display Identity Records
Submit a DIR for vetting
Submit a DIR for vetting. Sends the DIR back through the vetting cycle from any non-terminal status. When re-submitting from suspended or expired, the DIR's previous Branded Calling registration is torn down transactionally and its phone numbers flip back to submitted. When re-submitting from verified, the existing registration stays live throughout the new vetting cycle.
Returns 400 from submitted/in_review/permanently_rejected. Returns 400 if the DIR's business and financial references have not been submitted. Returns 409 if the DIR has an unresolved infringement claim.
post/dir/{dir_id}/submit
Path parameters
dir_idstring uuid required
Example:16635d38-75a6-4481-82e8-69af60e05011
The DIR id. Lowercase UUID.
Response
DIR submitted.
Example response
{
"data": {
"authorizer_email": "sam@acmeplumbing.example.com",
"authorizer_name": "Sam Owner",
"call_reasons": [
{
"created_at": "2026-04-26T18:06:51.940749Z",
"reason": "Appointment reminders"
}
],
"certify_brand_is_accurate": true,
"certify_ip_ownership": true,
"certify_no_shaft_content": true,
"created_at": "2026-04-26T18:06:51.940749Z",
"display_name": "Acme Plumbing",
"documents": [
{
"description": "Certificate of incorporation.",
"document_id": "2a7e8337-e803-4057-a4ae-26c40eb0bc6c",
"document_type": "business_registration"
}
],
"enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
"expiring_at": "2027-04-26T18:07:29.537981Z",
"id": "16635d38-75a6-4481-82e8-69af60e05011",
"logo_url": "https://acmeplumbing.example.com/logo-256.bmp",
"rejection_reasons": [
{
"code": "documentation_incomplete",
"detail": "Provided documents do not establish business identity.",
"message": "Please re-upload a clearer scan of the certificate.",
"title": "Documentation incomplete"
}
],
"submitted_at": "2026-04-26T18:07:03.716411Z",
"updated_at": "2026-04-26T18:09:24.785211Z",
"verified_at": "2026-04-26T18:07:29.537926Z"
}
}