Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

An Enterprise represents your business entity on the Telnyx platform. It’s the top-level resource required before you can use Number Reputation or Branded Calling features. Register your organization once, then opt into either or both products:
  • Number Reputation — monitor and manage spam reputation of your outbound calling numbers.
  • Branded Calling — display your business name, logo, and call reason on recipients’ screens (coming soon)

​
What you need

To create an enterprise, you’ll need:
FieldRequiredDescription
legal_nameyesRegistered legal name (max 255 chars).
doing_business_asyesDBA name (max 255 chars).
organization_typeyesOne of commercial, government, non_profit.
organization_legal_typeyesOne of corporation, llc, partnership, nonprofit, other.
country_codeyesISO 3166-1 alpha-2 code. Currently US and CA are supported.
jurisdiction_of_incorporationyesState/province/country of registration (e.g. Delaware).
websiteyesYour business website.
feinyesFederal Employer Identification Number (XX-XXXXXXX or XXXXXXXXX).
industryyesIndustry classification (e.g. technology, healthcare, retail).
number_of_employeesyesOne of 1-10, 11-50, 51-200, 201-500, 501-2000, 2001-10000, 10001+.
organization_contactyesObject with first_name, last_name, email, job_title, phone_number.
billing_contactyesObject with first_name, last_name, email, phone_number.
organization_physical_addressyesPhysical business address.
billing_addressyesBilling address.
role_typenoenterprise (default) or bpo (Business Process Outsourcer placing calls on behalf of other enterprises).
customer_referencenoOptional free-form identifier you can attach for your own bookkeeping (max 255 chars).

​
Quick start

​
1. Accept Terms of Service

Before creating an enterprise, accept the Terms of Service for the products you want to use. Each product has its own ToS — accept both if you plan to use both. 
# For Number Reputation
curl -X POST https://api.telnyx.com/v2/terms_of_service/number_reputation/agree \
  -H "Authorization: Bearer YOUR_API_KEY"

# For Branded Calling (Display Identity Records)
curl -X POST https://api.telnyx.com/v2/terms_of_service/branded_calling/agree \
  -H "Authorization: Bearer YOUR_API_KEY"

​
2. Create an enterprise

curl -X POST https://api.telnyx.com/v2/enterprises \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "legal_name": "Acme Plumbing LLC",
    "doing_business_as": "Acme Plumbing",
    "organization_type": "commercial",
    "organization_legal_type": "llc",
    "country_code": "US",
    "jurisdiction_of_incorporation": "Delaware",
    "website": "https://acmeplumbing.example.com",
    "fein": "12-3456789",
    "industry": "technology",
    "number_of_employees": "51-200",
    "organization_contact": {
      "first_name": "Sam",
      "last_name": "Owner",
      "email": "sam@acmeplumbing.example.com",
      "job_title": "Compliance Lead",
      "phone_number": "+13125550000"
    },
    "billing_contact": {
      "first_name": "Alex",
      "last_name": "Bill",
      "email": "billing@acmeplumbing.example.com",
      "phone_number": "+13125550001"
    },
    "organization_physical_address": {
      "country": "US",
      "administrative_area": "IL",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "100 Main St"
    },
    "billing_address": {
      "country": "US",
      "administrative_area": "IL",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "100 Main St"
    }
  }'
The response includes an id — use this enterprise ID for all subsequent API calls.

​
3. Next steps

​
Enterprise and product relationship

The enterprise is a shared resource — register once and use it across both Number Reputation and Branded Calling. Some fields are needed by one product more than the other (for example, doing_business_as and industry feed Number Reputation vetting; billing_address is needed for Branded Calling billing), so the API collects everything upfront and you don’t need to update later.

​
Access requirements

All Branded Calling and Number Reputation endpoints require a verified or enterprise-level Telnyx account. Trial and standard paid accounts cannot access these features. See Account Levels and Capabilities for details on upgrading.