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

Get a registered business

GET
/v1/branded-calling/enterprises/{id}

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

Response Body

application/json

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.brandedcalling.getBrandedCallingEnterprise({  path: {    id: 'abc123',  },});console.log(data);
{  "id": "string",  "legalName": "string",  "doingBusinessAs": "string",  "organizationType": "commercial",  "organizationLegalType": "corporation",  "countryCode": "US",  "jurisdictionOfIncorporation": "string",  "website": "string",  "feinLast4": "string",  "industry": "string",  "numberOfEmployees": "1-10",  "organizationContact": {    "firstName": "string",    "lastName": "string",    "email": "user@example.com",    "jobTitle": "string",    "phoneNumber": "string"  },  "billingContact": {    "firstName": "string",    "lastName": "string",    "email": "user@example.com",    "jobTitle": "string",    "phoneNumber": "string"  },  "physicalAddress": {    "streetAddress": "string",    "extendedAddress": "string",    "city": "string",    "administrativeArea": "string",    "postalCode": "string",    "country": "string"  },  "billingAddress": {    "streetAddress": "string",    "extendedAddress": "string",    "city": "string",    "administrativeArea": "string",    "postalCode": "string",    "country": "string"  },  "registered": true,  "createdAt": "2019-08-24T14:15:22Z"}
Was this page helpful?

Create a caller identity

A caller identity is what the callee sees: display name, logo and call reasons, backed by a registered business and three references the carrier vetting team phones. It starts in Zernio review (`requested`). Once approved, the carrier emails the authorizer a 6-digit code; confirm it with the verify-email endpoint and the identity goes into carrier vetting on its own. Track it with `GET` or the `branded_calling.identity.status_updated` webhook. Billing: $100 per identity per month, the first month charged when the identity is filed with the carrier and not refunded if the carrier rejects it, then monthly while the identity exists. Branded calls add $0.10 each, counted on every outbound call from a verified branded number to a US destination (whether or not the callee's carrier displayed the branding); the surcharge shows as `brandedCallUSD` on the call's billing and in `GET /v1/voice/calls/estimate` when you pass `from`.

Get a caller identity

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