Sign in
Branded Calling

Get a caller identity

Poll this for review and vetting progress, or subscribe to branded_calling.identity.status_updated.

get/v1/branded-calling/identities/{id}

Path parameters

idstring required

Response

The identity with its numbers.

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 2 of the 61 revisions of this API.2