Phone Number Validation & Type Lookup

{
  "type": "object",
  "required": [
    "phone_number"
  ],
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO 2-letter country code hint (optional)"
    },
    "phone_number": {
      "type": "string",
      "description": "Phone number in any format"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "e164": {
      "type": "string",
      "description": "The number reformatted to E.164, e.g. '+14155552671'."
    },
    "input": {
      "type": "string",
      "description": "The phone number exactly as submitted."
    },
    "valid": {
      "type": "boolean",
      "description": "Whether the number is a valid, assignable number."
    },
    "carrier": {
      "type": [
        "string",
        "null"
      ],
      "description": "Carrier network name. Observed as `null` on both real calibration calls (a US mobile number and a UK landline) -- a populated carrier value was never observed, so this field cannot be assumed to always resolve to a name."
    },
    "phone_type": {
      "type": "string",
      "description": "e.g. 'FIXED_LINE_OR_MOBILE', 'FIXED_LINE' -- observed values on the two real calibration calls; the full set of type values the endpoint can return (e.g. a distinct 'MOBILE' or 'VOIP' value) is not confirmed beyond these two."
    },
    "is_possible": {
      "type": "boolean",
      "description": "Whether the number is a possible length/pattern for its country."
    },
    "country_code": {
      "type": "string",
      "description": "Resolved ISO 2-letter country code."
    },
    "country_name": {
      "type": "string",
      "description": "Resolved country name."
    },
    "national_format": {
      "type": "string",
      "description": "The number reformatted in the resolved country's national style."
    },
    "international_format": {
      "type": "string",
      "description": "The number reformatted in international dialing style."
    }
  },
  "description": "The phone record, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}