{
  "$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"
    }
  }
}