Greynoise Time Series Intelligence Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://api-evangelist.github.io/greynoise/json-structure/greynoise-time-series-intelligence-structure.json",
  "name": "TimeSeriesIntelligence",
  "type": "object",
  "description": "Intelligence data for an IP in the timeseries dataset",
  "properties": {
    "first_seen": {
      "type": "date",
      "description": "The earliest date GreyNoise observed any activity from this IP.",
      "example": "2018-01-28"
    },
    "last_seen": {
      "type": "date",
      "description": "The most recent date GreyNoise observed any activity from this IP.",
      "example": "2018-02-28"
    },
    "found": {
      "type": "boolean",
      "description": "Indicates if the IP was observed scanning the GreyNoise sensor network. Also referred to as 'noise'.",
      "example": true
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "A list of activity/malware tags GreyNoise has applied to this\nIP.\n",
      "example": [
        "Mirai",
        "Telnet Worm"
      ]
    },
    "actor": {
      "type": "string",
      "description": "The overt actor this IP is associated with.",
      "example": "Shodan.io"
    },
    "spoofable": {
      "type": "boolean",
      "description": "This IP address has been opportunistically scanning the Internet, however has failed to complete a full TCP connection. Any reported activity could be spoofed.",
      "example": true
    },
    "classification": {
      "type": "string",
      "description": "The classification of the IP address, either \"benign\", \"malicious\", or \"unknown\", based on the activity observed by GreyNoise.",
      "enum": [
        "benign",
        "malicious",
        "unknown"
      ],
      "example": "benign"
    },
    "cves": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "A list of CVEs associate with this IP.",
      "example": [
        "CVE-2020-1234",
        "CVE-2021-2345"
      ]
    },
    "vpn": {
      "type": "boolean",
      "description": "This IP is associated with a VPN service. Activity, malicious or otherwise, should not be attributed to the VPN service provider.",
      "example": true
    },
    "vpn_service": {
      "type": "string",
      "description": "Name of associated VPN Service.",
      "example": "IPVANISH_VPN"
    },
    "tor": {
      "type": "boolean",
      "description": "Whether or not the device is a known Tor exit node.",
      "example": false
    },
    "last_seen_timestamp": {
      "type": "datetime",
      "description": "The timestamp of the last observed activity from this IP.",
      "example": "2025-01-15T12:30:45Z"
    },
    "metadata": {
      "$ref": "./greynoise-metadata-v3-structure.json#"
    },
    "raw_data": {
      "$ref": "./greynoise-time-series-raw-data-structure.json#"
    }
  }
}