Zernio
Zernio
API Reference

Branded Calling

List pre-approved call reasonsGETList registered businessesGETList caller identitiesGETList the numbers on a caller identityGETRegister a business for Branded CallingPOSTCreate a caller identityPOSTGet a registered businessGETGet a caller identityGETEdit or resubmit a caller identityPATCHDelete a registered businessDELETEDelete a caller identityDELETEAttach numbers to a verified identityPOSTConfirm the authorizer's codePOSTDetach numbers from an identityDELETEResend the authorizer's codePOST
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
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

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.brandedcalling.confirmBrandedCallingAuthorizerEmail({  path: {    id: 'abc123',  },  body: {    code: 'abc123',  },});console.log(data);
{  "id": "string",  "enterpriseId": "string",  "displayName": "string",  "callReasons": [    "string"  ],  "callReasonsPreApproved": true,  "logoUrl": "string",  "authorizer": {    "name": "string",    "email": "user@example.com"  },  "references": {    "business": [      {        "fullName": "string",        "jobTitle": "string",        "organization": "string",        "relationshipToRegistrant": "string",        "phoneNumber": "string",        "email": "user@example.com",        "timezone": "string"      },      {        "fullName": "string",        "jobTitle": "string",        "organization": "string",        "relationshipToRegistrant": "string",        "phoneNumber": "string",        "email": "user@example.com",        "timezone": "string"      }    ],    "financial": {      "fullName": "string",      "jobTitle": "string",      "organization": "string",      "relationshipToRegistrant": "string",      "phoneNumber": "string",      "email": "user@example.com",      "timezone": "string"    }  },  "status": "requested",  "rejectionReasons": [    {      "code": "string",      "title": "string",      "detail": "string",      "message": "string"    }  ],  "reviewNote": "string",  "reviewRequest": {    "id": "string",    "intro": "string",    "points": [      {        "id": "string",        "title": "string",        "detail": "string",        "answer": "text"      }    ]  },  "emailVerifiedAt": "2019-08-24T14:15:22Z",  "submittedAt": "2019-08-24T14:15:22Z",  "verifiedAt": "2019-08-24T14:15:22Z",  "expiringAt": "2019-08-24T14:15:22Z",  "numbers": [    {      "phoneNumberId": "string",      "phoneNumber": "string",      "status": "submitted",      "rejectionReason": {        "code": "string",        "title": "string",        "detail": "string",        "message": "string"      },      "verifiedAt": "2019-08-24T14:15:22Z",      "addedAt": "2019-08-24T14:15:22Z"    }  ],  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}
Was this page helpful?

Attach numbers to a verified identity

Files a Letter of Authorization signed by you (Zernio is named as the authorized agent managing the numbers) and opens a vetting batch of up to 15 US numbers you own. The batch is all-or-nothing: one ineligible number refuses the whole call. Each number shows the identity once its own status reaches `verified`. A number belongs to one identity at a time.

Detach numbers from an identity

Deregisters the numbers at the carrier and frees them for another identity. Up to 100 per call.

code*string
Match^[0-9]{6}$