EnterpriseListPublic

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/telnyx/main/json-schema/telnyx-enterprise-list-public-schema.json",
  "title": "EnterpriseListPublic",
  "x-generated": "2026-10-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/telnyx-enterprises-api-openapi.yml#/components/schemas/EnterpriseListPublic",
  "properties": {
    "data": {
      "items": {
        "$ref": "#/$defs/EnterprisePublic"
      },
      "type": "array"
    },
    "meta": {
      "$ref": "#/$defs/MetaInfo"
    }
  },
  "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"
    },
    "EnterprisePublic": {
      "properties": {
        "billing_address": {
          "$ref": "#/$defs/BillingAddress"
        },
        "billing_contact": {
          "$ref": "#/$defs/BillingContact"
        },
        "corporate_registration_number": {
          "description": "Corporate registration number",
          "type": [
            "string",
            "null"
          ]
        },
        "country_code": {
          "description": "ISO 3166-1 alpha-2 country code",
          "type": "string"
        },
        "created_at": {
          "description": "When the enterprise was created",
          "format": "date-time",
          "type": "string"
        },
        "customer_reference": {
          "description": "Customer reference identifier",
          "type": [
            "string",
            "null"
          ]
        },
        "doing_business_as": {
          "description": "DBA name",
          "type": "string"
        },
        "dun_bradstreet_number": {
          "description": "D-U-N-S Number",
          "type": [
            "string",
            "null"
          ]
        },
        "fein": {
          "description": "Federal Employer Identification Number",
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "description": "Unique identifier of the enterprise",
          "format": "uuid",
          "type": "string"
        },
        "industry": {
          "description": "Industry classification",
          "type": [
            "string",
            "null"
          ]
        },
        "legal_name": {
          "description": "Legal name of the enterprise",
          "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",
            "null"
          ]
        },
        "organization_contact": {
          "$ref": "#/$defs/OrganizationContact"
        },
        "organization_legal_type": {
          "description": "Legal structure type",
          "enum": [
            "corporation",
            "llc",
            "partnership",
            "nonprofit",
            "other"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "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",
          "type": [
            "string",
            "null"
          ]
        },
        "professional_license_number": {
          "description": "Professional license number",
          "type": [
            "string",
            "null"
          ]
        },
        "role_type": {
          "description": "Role type in Branded Calling / Number Reputation services",
          "enum": [
            "enterprise",
            "bpo"
          ],
          "type": "string"
        },
        "updated_at": {
          "description": "When the enterprise was last updated",
          "format": "date-time",
          "type": "string"
        },
        "website": {
          "description": "Company website URL",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "MetaInfo": {
      "properties": {
        "page_number": {
          "description": "Current page number",
          "type": "integer"
        },
        "page_size": {
          "description": "Items per page",
          "type": "integer"
        },
        "total_pages": {
          "description": "Total number of pages",
          "type": "integer"
        },
        "total_results": {
          "description": "Total number of results",
          "type": "integer"
        }
      },
      "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"
    }
  }
}