OperatorInformationResult

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-operator-information-result-schema.json",
  "title": "OperatorInformationResult",
  "description": "Represents a search result containing format and operator information associated with the requested phone numbers",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-azure-communication-services-obtain-operator-information-for-requested-numbers-api-openapi.yml#/components/schemas/OperatorInformationResult",
  "type": "object",
  "properties": {
    "values": {
      "description": "Results of a search.\nThis array will have one entry per requested phone number which will contain the relevant operator information.",
      "type": "array",
      "items": {
        "$ref": "#/$defs/OperatorInformation"
      }
    }
  },
  "$defs": {
    "OperatorDetails": {
      "description": "Represents metadata describing the operator of a phone number",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the phone operator",
          "type": "string"
        },
        "mobileNetworkCode": {
          "description": "Mobile Network Code, 2 or 3 decimal digits that identify mobile networks within a country/region",
          "type": "string"
        },
        "mobileCountryCode": {
          "description": "Mobile Country Code, 3 decimal digits that identify a country/region",
          "type": "string"
        }
      }
    },
    "OperatorInformation": {
      "description": "Represents metadata about a phone number that is controlled/provided by that phone number's operator.",
      "required": [
        "phoneNumber"
      ],
      "type": "object",
      "properties": {
        "phoneNumber": {
          "description": "E.164 formatted string representation of the phone number",
          "type": "string"
        },
        "nationalFormat": {
          "description": "National format of the phone number",
          "type": "string"
        },
        "internationalFormat": {
          "description": "International format of the phone number",
          "type": "string"
        },
        "isoCountryCode": {
          "description": "ISO 3166-1 two character ('alpha-2') code associated with the phone number.",
          "type": "string"
        },
        "numberType": {
          "description": "Type of service associated with the phone number",
          "enum": [
            "unknown",
            "other",
            "geographic",
            "mobile"
          ],
          "type": "string",
          "x-ms-enum": {
            "name": "OperatorNumberType",
            "modelAsString": true
          }
        },
        "operatorDetails": {
          "$ref": "#/$defs/OperatorDetails"
        }
      }
    }
  }
}