Phone Number Validation & E.164 Normalization

{
  "type": "object",
  "required": [
    "phone_string"
  ],
  "properties": {
    "phone_string": {
      "type": "string",
      "description": "Phone number to normalize"
    },
    "default_country": {
      "type": "string",
      "description": "ISO country code (e.g. SE)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "input",
    "valid"
  ],
  "properties": {
    "e164": {
      "type": "string",
      "description": "E.164-formatted number (e.g. '+12125550198'). Only observed on a fully valid number -- absent on the invalid-number fixture, where the number could not be parsed at all."
    },
    "type": {
      "type": "string",
      "description": "Line type, e.g. 'FIXED_LINE_OR_MOBILE' -- observed as a single combined category on the one valid fixture captured; other values are documented by the vendor but unconfirmed."
    },
    "error": {
      "type": "string",
      "description": "A human-readable parse-failure message, present instead of the normalized fields above when the number could not be parsed (e.g. too short, no country context)."
    },
    "input": {
      "type": "string",
      "description": "The phone number text exactly as submitted, echoed back."
    },
    "valid": {
      "type": "boolean",
      "description": "Whether the number is a fully valid number for its detected region."
    },
    "is_possible": {
      "type": "boolean",
      "description": "Whether the number's length/shape is at least plausible for its region. Only observed on a valid number."
    },
    "calling_code": {
      "type": "string",
      "description": "Detected calling code (e.g. '+1'). Only observed on a valid number."
    },
    "country_code": {
      "type": "string",
      "description": "Detected ISO country code (e.g. 'US'). Only observed on a valid number."
    },
    "national_format": {
      "type": "string",
      "description": "Locally-formatted number (e.g. '(212) 555-0198'). Only observed on a valid number."
    },
    "international_format": {
      "type": "string",
      "description": "Internationally-formatted number (e.g. '+1 212 555 0198'). Only observed on a valid number."
    }
  },
  "description": "The phone normalization result, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}