---
title: "Retrieve a history of how many samples were scanned"
method: GET
path: "/sampleHistory"
tags: ["info"]
---

# Retrieve a history of how many samples were scanned

`GET /sampleHistory`

## Request

- Base URL: `http://localhost:8080/api/v1`
- URL: `http://localhost:8080/api/v1/sampleHistory`
- Auth: none declared
- TypeScript: <https://skmtc.dev/nextron-systems/apis/thor-thunderstorm-api/docs/sampleHistory/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a history of how many samples were scanned.

## Query parameters

- `aggregate` integer
- `limit` integer

## Response `200`

Returns a JSON Map with each time mapped to the samples scanned from the last time mentioned to that time

- TimestampMap: Map of timestamps to integer values

## Other responses

- `400`: Invalid parameters given

## Changes

- **2026-04-24** `f8207ca0b201`: 2 warning
  - for the `query` request parameter `aggregate`, the min was set to `0.00`
  - for the `query` request parameter `limit`, the min was set to `0.00`

[Operation history](https://skmtc.dev/nextron-systems/apis/thor-thunderstorm-api/changes/sampleHistory/get.md)

---

[API](https://skmtc.dev/nextron-systems/apis/thor-thunderstorm-api.md) - [All operations](https://skmtc.dev/nextron-systems/apis/thor-thunderstorm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nextron-systems/apis/thor-thunderstorm-api/revisions/f8207ca0b201?raw)