Skip to main content
Get the number of new infections per week across the entire dataset. Use this to power a trend chart showing how infostealer activity has evolved over time.

​
Request

GET /v1/stats/timeline · Required scope: none — any valid key · Not paginated Response is not tier-masked and is cached for 1 hour.

​
Example request

curl -X GET https://api.vantaprism.me/v1/stats/timeline \
  -H "api-key: $VANTAPRISM_API_KEY"

​
Response

200 OK — array of StatsTimelineEntry, one per week. 
{
  "data": [
    { "week": "2026-05-18", "infections": 412883 },
    { "week": "2026-05-25", "infections": 438201 },
    { "week": "2026-06-01", "infections": 451092 },
    { "week": "2026-06-08", "infections": 467734 }
  ],
  "meta": {
    "request_id": "req_01HZXK3Q7N8YV6F3M2P9JABCDE",
    "took_ms": 7.4,
    "tier": "free",
    "masked_fields": []
  }
}
FieldDescription
weekISO 8601 date (Monday) marking the start of the week
infectionsNumber of new infections recorded during that week

​
Not paginated

This endpoint returns the full timeline in a single response — cursor/limit/sort_direction do not apply.

​
Errors

See Errors for the full catalog. Only the standard auth and rate-limit errors apply — there is no endpoint-specific validation.

​
Tier notes

This endpoint is not tier-masked — all tiers receive identical values. Responses are cached for 1 hour.