Device Status Api Device Connectivity Request Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/at-t-developer-hub/refs/heads/main/json-structure/device-status-api-device-connectivity-request-structure.json",
  "description": "DeviceConnectivityRequest schema",
  "type": "object",
  "required": [
    "device"
  ],
  "properties": {
    "device": {
      "type": "object",
      "description": "Device identifier for connectivity status queries",
      "properties": {
        "phoneNumber": {
          "type": "string",
          "description": "Mobile phone number in E.164 format",
          "example": "+12125551234"
        },
        "ipv4Address": {
          "type": "object",
          "description": "Device IPv4 address (alternative to phoneNumber)",
          "properties": {
            "publicAddress": {
              "type": "string",
              "description": "Public IPv4 address",
              "example": "203.0.113.42"
            },
            "privateAddress": {
              "type": "string",
              "description": "Private IPv4 address",
              "example": "10.0.0.5"
            },
            "publicPort": {
              "type": "int32",
              "description": "Public port if behind NAT",
              "example": 54321
            }
          }
        },
        "networkAccessIdentifier": {
          "type": "string",
          "description": "Network access identifier (alternative to phoneNumber)",
          "example": "user@example.com"
        }
      }
    }
  },
  "name": "DeviceConnectivityRequest"
}