Telnyx · Schema

EnterpriseCreate

CommunicationsCPaaSVoiceSMSIoTTelecommunicationsMessagingArtificial IntelligenceMCPVoice AIPhone NumbersInference

Properties

Name	Type	Description
billing_address	object
billing_contact	object
corporate_registration_number	string	Corporate registration number (optional)
country_code	string	Country code. Currently only 'US' is accepted.
customer_reference	string	Optional customer reference identifier for your own tracking
doing_business_as	string	Primary business name / DBA name
dun_bradstreet_number	string	D-U-N-S Number (optional)
fein	string	Federal Employer Identification Number. Format: XX-XXXXXXX or 9-digit number (minimum 9 digits).
industry	string	Industry classification. Case-insensitive. Accepted values: accounting, finance, billing, collections, business, charity, nonprofit, communications, telecom, customer service, support, delivery, shipp
legal_name	string	Legal name of the enterprise
number_of_employees	string	Employee count range
organization_contact	object
organization_legal_type	string	Legal structure type
organization_physical_address	object
organization_type	string	Type of organization
primary_business_domain_sic_code	string	SIC Code (optional)
professional_license_number	string	Professional license number (optional)
role_type	string	Role type in Branded Calling / Number Reputation services
website	string	Enterprise website URL. Accepts any string — no URL format validation enforced.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/telnyx/main/json-schema/telnyx-enterprise-create-schema.json",
  "title": "EnterpriseCreate",
  "x-generated": "2026-10-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/telnyx-enterprises-api-openapi.yml#/components/schemas/EnterpriseCreate",
  "properties": {
    "billing_address": {
      "$ref": "#/$defs/BillingAddress"
    },
    "billing_contact": {
      "$ref": "#/$defs/BillingContact"
    },
    "corporate_registration_number": {
      "description": "Corporate registration number (optional)",
      "maxLength": 100,
      "type": "string"
    },
    "country_code": {
      "description": "Country code. Currently only 'US' is accepted.",
      "maxLength": 2,
      "minLength": 2,
      "type": "string"
    },
    "customer_reference": {
      "description": "Optional customer reference identifier for your own tracking",
      "maxLength": 255,
      "type": "string"
    },
    "doing_business_as": {
      "description": "Primary business name / DBA name",
      "maxLength": 255,
      "type": "string"
    },
    "dun_bradstreet_number": {
      "description": "D-U-N-S Number (optional)",
      "maxLength": 20,
      "type": "string"
    },
    "fein": {
      "description": "Federal Employer Identification Number. Format: XX-XXXXXXX or 9-digit number (minimum 9 digits).",
      "maxLength": 20,
      "type": "string"
    },
    "industry": {
      "description": "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",
      "type": "string"
    },
    "legal_name": {
      "description": "Legal name of the enterprise",
      "maxLength": 64,
      "minLength": 3,
      "type": "string"
    },
    "number_of_employees": {
      "description": "Employee count range",
      "enum": [
        "1-10",
        "11-50",
        "51-200",
        "201-500",
        "501-2000",
        "2001-10000",
        "10001+"
      ],
      "type": "string"
    },
    "organization_contact": {
      "$ref": "#/$defs/OrganizationContact"
    },
    "organization_legal_type": {
      "description": "Legal structure type",
      "enum": [
        "corporation",
        "llc",
        "partnership",
        "nonprofit",
        "other"
      ],
      "type": "string"
    },
    "organization_physical_address": {
      "$ref": "#/$defs/PhysicalAddress"
    },
    "organization_type": {
      "description": "Type of organization",
      "enum": [
        "commercial",
        "government",
        "non_profit"
      ],
      "type": "string"
    },
    "primary_business_domain_sic_code": {
      "description": "SIC Code (optional)",
      "maxLength": 10,
      "type": "string"
    },
    "professional_license_number": {
      "description": "Professional license number (optional)",
      "maxLength": 100,
      "type": "string"
    },
    "role_type": {
      "default": "enterprise",
      "description": "Role type in Branded Calling / Number Reputation services",
      "enum": [
        "enterprise",
        "bpo"
      ],
      "type": "string"
    },
    "website": {
      "description": "Enterprise website URL. Accepts any string — no URL format validation enforced.",
      "maxLength": 255,
      "type": "string"
    }
  },
  "required": [
    "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"
  ],
  "type": "object",
  "$defs": {
    "BillingAddress": {
      "properties": {
        "administrative_area": {
          "description": "State or province",
          "maxLength": 100,
          "type": "string"
        },
        "city": {
          "description": "City name",
          "maxLength": 100,
          "type": "string"
        },
        "country": {
          "description": "Country name (e.g., United States)",
          "maxLength": 100,
          "type": "string"
        },
        "extended_address": {
          "description": "Additional address line (suite, apt, etc.)",
          "maxLength": 255,
          "type": [
            "string",
            "null"
          ]
        },
        "postal_code": {
          "description": "ZIP or postal code",
          "maxLength": 20,
          "type": "string"
        },
        "street_address": {
          "description": "Street address",
          "maxLength": 255,
          "type": "string"
        }
      },
      "required": [
        "country",
        "administrative_area",
        "city",
        "postal_code",
        "street_address"
      ],
      "type": "object"
    },
    "BillingContact": {
      "properties": {
        "email": {
          "description": "Contact's email address",
          "format": "email",
          "maxLength": 255,
          "type": "string"
        },
        "first_name": {
          "description": "Contact's first name",
          "maxLength": 255,
          "type": "string"
        },
        "last_name": {
          "description": "Contact's last name",
          "maxLength": 255,
          "type": "string"
        },
        "phone_number": {
          "description": "Contact's phone number (10-15 digits)",
          "maxLength": 20,
          "type": "string"
        }
      },
      "required": [
        "first_name",
        "last_name",
        "email",
        "phone_number"
      ],
      "type": "object"
    },
    "OrganizationContact": {
      "description": "Organization contact information. Note: the response returns this object with the phone field as 'phone' (not 'phone_number').",
      "properties": {
        "email": {
          "description": "Contact's email address",
          "format": "email",
          "maxLength": 255,
          "type": "string"
        },
        "first_name": {
          "description": "Contact's first name",
          "maxLength": 255,
          "type": "string"
        },
        "job_title": {
          "description": "Contact's job title (required)",
          "maxLength": 255,
          "type": "string"
        },
        "last_name": {
          "description": "Contact's last name",
          "maxLength": 255,
          "type": "string"
        },
        "phone": {
          "description": "Contact's phone number in E.164 format",
          "maxLength": 20,
          "type": "string"
        }
      },
      "required": [
        "first_name",
        "last_name",
        "email",
        "job_title",
        "phone"
      ],
      "type": "object"
    },
    "PhysicalAddress": {
      "properties": {
        "administrative_area": {
          "description": "State or province",
          "maxLength": 100,
          "type": "string"
        },
        "city": {
          "description": "City name",
          "maxLength": 100,
          "type": "string"
        },
        "country": {
          "description": "Country name (e.g., United States)",
          "maxLength": 100,
          "type": "string"
        },
        "extended_address": {
          "description": "Additional address line (suite, apt, etc.)",
          "maxLength": 255,
          "type": [
            "string",
            "null"
          ]
        },
        "postal_code": {
          "description": "ZIP or postal code",
          "maxLength": 20,
          "type": "string"
        },
        "street_address": {
          "description": "Street address",
          "maxLength": 255,
          "type": "string"
        }
      },
      "required": [
        "country",
        "administrative_area",
        "city",
        "postal_code",
        "street_address"
      ],
      "type": "object"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/telnyx-enterprise-create"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.