Sign in
Branded Calling

Register a business for Branded Calling

Stores the legal entity behind your caller identities. Nothing is filed with the carrier until the business's first identity passes review. Only businesses registered in the US or Canada qualify (a FEIN or Canadian equivalent is required); any other country returns 422. Send an Idempotency-Key so a retry replays the original response instead of registering the business twice.

post/v1/branded-calling/enterprises

Headers

Idempotency-Keystring

Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.

Request body

legalNamestring required

Exactly as on the tax record.

doingBusinessAsstring required
organizationType'commercial' | 'government' | 'non_profit' required
organizationLegalType'corporation' | 'llc' | 'partnership' | 'nonprofit' | 'other' required
countryCodestring required

ISO 3166-1 alpha-2. US or CA.

jurisdictionOfIncorporationstring required

State, province or country of registration.

websitestring uri required
feinstring required

US Federal Employer Identification Number (NN-NNNNNNN) or the Canadian equivalent. Stored encrypted; only the last four digits are ever returned.

industrystring required

One of the carrier industry labels, e.g. technology, healthcare, retail, finance, legal, insurance, real estate, logistics, education.

numberOfEmployees'1-10' | '11-50' | '51-200' | '201-500' | '501-2000' | '2001-10000' | '10001+' required

Response

Business stored.

idstring
legalNamestring
doingBusinessAsstring
organizationType'commercial' | 'government' | 'non_profit'
organizationLegalType'corporation' | 'llc' | 'partnership' | 'nonprofit' | 'other'
countryCode'US' | 'CA'
jurisdictionOfIncorporationstring
websitestring
feinLast4string

Last four digits of the tax id; the full id is never returned.

industrystring
numberOfEmployees'1-10' | '11-50' | '51-200' | '201-500' | '501-2000' | '2001-10000' | '10001+'
registeredboolean

True once the business exists at the carrier (happens when its first identity passes review).

createdAtstring date-time nullable

Changes

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