Get Test Stats | SpeechifyAI API

Aggregate pass-rate metrics over the last N days. Returns dense daily buckets (one entry per day, zero-filled) plus totals and a per-type breakdown. Powers the header chart on the global tests page. Default window is 30 days, max 90.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Query parameters

window_daysintegerOptional

Trailing window in days (default 30, max 90).

Response headers

X-Request-IDstring

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an X-Request-ID request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify’s server-side logs, and it matches the request_id field in the error envelope.

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an `X-Request-ID` request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify's server-side logs, and it matches the `request_id` field in the error envelope.

Response

Stats payload.

window_daysinteger

bucketslist of objects

total_runsinteger

passed_runsinteger

failed_runsinteger

errored_runsinteger

avg_duration_msinteger

by_typemap from strings to integers

Errors

401

Unauthorized Error

1	{
2	"window_days": 1,
3	"buckets": [
4	{
5	"day": "example",
6	"passed": 1,
7	"failed": 1,
8	"errored": 1
9	}
10	],
11	"total_runs": 1,
12	"passed_runs": 1,
13	"failed_runs": 1,
14	"errored_runs": 1,
15	"avg_duration_ms": 5000,
16	"by_type": {
17	"key": 1
18	}
19	}