TimeSeriesStatsResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.github.io/greynoise/json-schema/greynoise-time-series-stats-response-schema.json",
  "title": "TimeSeriesStatsResponse",
  "type": "object",
  "description": "Response object for the timeseries stats/aggregation endpoint.\nThis provides aggregated IP counts over time intervals matching\na GNQL query.\n",
  "properties": {
    "count": {
      "type": "integer",
      "description": "The sum of all IP counts across all time intervals",
      "example": 1500
    },
    "min": {
      "type": "integer",
      "description": "The minimum IP count observed in any single time interval",
      "example": 10
    },
    "max": {
      "type": "integer",
      "description": "The maximum IP count observed in any single time interval",
      "example": 250
    },
    "data": {
      "type": "array",
      "items": {
        "$ref": "./greynoise-time-series-stats-record-schema.json#"
      },
      "description": "Array of aggregated data points, one per time interval",
      "example": []
    }
  },
  "example": {
    "count": 1500,
    "min": 10,
    "max": 250,
    "data": [
      {
        "date": "2025-11-10 14:00:00.000",
        "count": 125
      },
      {
        "date": "2025-11-10 15:00:00.000",
        "count": 250
      },
      {
        "date": "2025-11-10 16:00:00.000",
        "count": 180
      }
    ]
  }
}