---
title: "Historical statistics"
method: GET
path: "/stats/history"
tags: ["API Keys"]
---

# Historical statistics

`GET /stats/history`

Returns per-day statistics for the requested period. Requires authentication — these figures include revenue and are not public.

## Query parameters

- `period` integer

## Response `200`

Historical stats array

- object[]
  - `date` string, date, required
  - `total` integer, required
  - `revenue` number, required
  - `p50_ms` integer, nullable — Median served latency for the day, in milliseconds. Null below 20 measured requests: a percentile over a handful of samples is noise, and a gap is more honest than a made-up figure.
  - `p95_ms` integer, nullable — 95th percentile of served latency. Same 20-sample floor as p50_ms.
  - `p99_ms` integer, nullable — The tail: 99th percentile of served latency, which is what a caller making thousands of requests is exposed to and what a timeout budget should be set from. Its floor is 100 measured requests, not 20, and that is arithmetic rather than caution: the rank n*0.99 lands on the same row as n*0.95 at 20 samples, so a lower floor would publish the p95 twice under two names. Null below it.

## Other responses

- `403` — Authentication required — send Authorization: Bearer ifk_...

## Changes

> 14 revisions in range; 5 could not be searched.

- **2026-08-29** `9499dba434ea` — 3 info
  - added the optional property `items/p50_ms` to the response with the `200` status
  - added the optional property `items/p95_ms` to the response with the `200` status
  - added the optional property `items/p99_ms` to the response with the `200` status
- **2026-07-26** `81718095283e` — 4 info
  - the endpoint scheme security `apiKey` was added to the API
  - api tag `API Keys` added
  - api tag `Free` removed
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/ibanforge/apis/ibanforge-api/changes/stats/history/get.md)

---

[API](https://skmtc.dev/ibanforge/apis/ibanforge-api.md) · [All operations](https://skmtc.dev/ibanforge/apis/ibanforge-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibanforge/ibanforge-api/revisions/9499dba434ea/schema)