Sign in
Enterprises

Create an enterprise

Create a new enterprise for Branded Calling / Number Reputation services.

Registers the enterprise in the Branded Calling / Number Reputation services, enabling it to create Display Identity Records (DIRs) or enroll in Number Reputation monitoring.

Required Fields: legal_name, doing_business_as, organization_type, country_code, website, fein, industry, number_of_employees, organization_legal_type, organization_contact, billing_contact, organization_physical_address, billing_address

post/enterprises

Request body

legal_namestring required

Legal name of the enterprise

doing_business_asstring required

Primary business name / DBA name

organization_type'commercial' | 'government' | 'non_profit' required

Type of organization

country_codestring required

Country code. Currently only 'US' is accepted.

role_type'enterprise' | 'bpo'

Role type in Branded Calling / Number Reputation services

websitestring required

Enterprise website URL. Accepts any string — no URL format validation enforced.

feinstring required

Federal Employer Identification Number. Format: XX-XXXXXXX or 9-digit number (minimum 9 digits).

industrystring required

Industry classification. Case-insensitive. Accepted values: accounting, finance, billing, collections, business, charity, nonprofit, communications, telecom, customer service, support, delivery, shipping, logistics, education, financial, banking, government, public, healthcare, health, pharmacy, medical, insurance, legal, law, notifications, scheduling, real estate, property, retail, ecommerce, sales, marketing, software, technology, tech, media, surveys, market research, travel, hospitality, hotel

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

Employee count range

organization_legal_type'corporation' | 'llc' | 'partnership' | 'nonprofit' | 'other' required

Legal structure type

primary_business_domain_sic_codestring

SIC Code (optional)

corporate_registration_numberstring

Corporate registration number (optional)

professional_license_numberstring

Professional license number (optional)

dun_bradstreet_numberstring

D-U-N-S Number (optional)

customer_referencestring

Optional customer reference identifier for your own tracking

Example request

{
  "legal_name": "Acme Corp Inc.",
  "doing_business_as": "Acme",
  "organization_type": "commercial",
  "country_code": "US",
  "website": "https://acme.com",
  "fein": "12-3456789",
  "industry": "technology",
  "number_of_employees": "51-200",
  "organization_legal_type": "corporation",
  "primary_business_domain_sic_code": "7372",
  "organization_contact": {
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane.smith@acme.com",
    "job_title": "VP of Engineering",
    "phone": "+16035551234"
  },
  "billing_contact": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "billing@acme.com",
    "phone_number": "15551234568"
  },
  "organization_physical_address": {
    "country": "United States",
    "administrative_area": "Illinois",
    "city": "Chicago",
    "postal_code": "60601",
    "street_address": "123 Main St",
    "extended_address": "Suite 400"
  },
  "billing_address": {
    "country": "United States",
    "administrative_area": "Illinois",
    "city": "Chicago",
    "postal_code": "60601",
    "street_address": "123 Main St",
    "extended_address": "Suite 400"
  }
}

Response

Enterprise created successfully

Example response

{
  "data": {
    "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "legal_name": "Acme Corp Inc.",
    "doing_business_as": "Acme",
    "country_code": "US",
    "organization_contact": {
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane.smith@acme.com",
      "job_title": "VP of Engineering",
      "phone": "+16035551234"
    },
    "billing_contact": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "billing@acme.com",
      "phone_number": "15551234568"
    },
    "organization_physical_address": {
      "country": "United States",
      "administrative_area": "Illinois",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "123 Main St",
      "extended_address": "Suite 400"
    },
    "billing_address": {
      "country": "United States",
      "administrative_area": "Illinois",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "123 Main St",
      "extended_address": "Suite 400"
    }
  }
}

Changes