Sign in
Branded Calling

Confirm the authorizer's code

The last customer step. On success the stored references are filed and the identity is submitted to carrier vetting in the same call (in_review). If a later step fails the identity stays pending_email_verification with the email already verified; calling again resumes from that step.

post/v1/branded-calling/identities/{id}/verify-email/confirm

Path parameters

idstring required

Request body

codestring required

Response

The identity, now in carrier vetting.

idstring
enterpriseIdstring
displayNamestring
callReasonsstring[]
callReasonsPreApprovedboolean

Every call reason matches the carrier catalogue (GET /v1/branded-calling/call-reasons); anything else is vetted by hand and takes longer.

logoUrlstring nullable

The image you sent. Zernio hosts the 256x256 BMP the carriers require.

status'requested' | 'changes_requested' | 'rejected' | 'pending_email_verification' | 'in_review' | 'verified' | 'suspended' | 'expired' | 'permanently_rejected'

requested = in Zernio review; changes_requested = answer the review (PATCH); pending_email_verification = confirm the code emailed to the authorizer; in_review = with the carrier vetting team; verified = attach numbers; rejected = fix and PATCH to resubmit; suspended = an infringement claim is open; expired = the yearly verification lapsed; permanently_rejected = terminal.

reviewNotestring nullable

The open change request, as text.

emailVerifiedAtstring date-time nullable
submittedAtstring date-time nullable
verifiedAtstring date-time nullable
expiringAtstring date-time nullable

Verification lasts one year; Zernio resubmits 30 days before this date.

createdAtstring date-time nullable
updatedAtstring date-time nullable

Changes

Changed in 1 of the 61 revisions of this API.1