IPTimelineResponse

SecurityThreat IntelligenceCybersecurityIP ReputationVulnerability ManagementNetwork TelemetrySOC AutomationPublic APIs

Properties

Name Type Description
results array
metadata object
View JSON Schema on GitHub

JSON Schema

greynoise-ip-timeline-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.github.io/greynoise/json-schema/greynoise-ip-timeline-response-schema.json",
  "title": "IPTimelineResponse",
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "data": {
            "type": "integer",
            "description": "Hourly activity count for the field value in this time bucket",
            "example": 1
          },
          "label": {
            "type": "string",
            "description": "A label that corresponds to a distinct value for the\ngiven field\n",
            "example": "unknown"
          },
          "timestamp": {
            "type": "string",
            "description": "Time range bucket based on granularity - the timestamp\nrepresents the start of the bucket\n",
            "format": "date-time",
            "example": "2023-01-23T00:00:00Z"
          }
        }
      }
    },
    "metadata": {
      "type": "object",
      "properties": {
        "ip": {
          "type": "string",
          "description": "IP queried",
          "example": "36.32.2.102"
        },
        "field": {
          "type": "string",
          "description": "Field over which to show change",
          "example": "classification"
        },
        "first_seen": {
          "type": "string",
          "description": "The earliest date GreyNoise observed any activity from this IP.\n",
          "example": "2022-06-15"
        },
        "start": {
          "type": "string",
          "format": "date-time",
          "description": "Start of time range for data",
          "example": "2023-01-18T00:00:00Z"
        },
        "end": {
          "type": "string",
          "format": "date-time",
          "description": "End of time range for data",
          "example": "2023-01-25T21:55:18.486036894Z"
        },
        "granularity": {
          "type": "string",
          "description": "Granularity at which to show data",
          "example": "1d"
        },
        "metric": {
          "type": "string",
          "description": "The metric used within the data field",
          "example": "count"
        }
      }
    }
  }
}