Skip to content
Introducing STTv6See what's new
API referenceOther

Get concurrent streams history

Returns historical concurrent stream counts for the project, aggregated per period. The project is implied by the API key used for authentication. Region-scoped. Every aggregation period in the requested window is returned, with no gaps. Periods with no recorded activity have every field set to 0.

GET
https://api.soniox.com/v1/concurrent-streams-history

Returns historical concurrent stream counts for the project, aggregated per period. The project is implied by the API key used for authentication. Region-scoped.

Every aggregation period in the requested window is returned, with no gaps. Periods with no recorded activity have every field set to 0.

Headers

AuthorizationRequiredBearer <SONIOX_API_KEY>

A project API key.

Query parameters

start_timeRequiredstring

Start of the time window (inclusive). Must be an ISO 8601 timestamp in UTC (e.g. 2026-04-28T09:00:00Z). Filters by period_start.

end_timeRequiredstring

End of the time window (exclusive). Must be an ISO 8601 timestamp in UTC (e.g. 2026-04-28T09:00:00Z) and strictly after start_time. Filters by period_start.

period_secRequiredinteger

Aggregation period in seconds. One of 60 (per-minute), 3600 (hourly), 86400 (daily). The period also caps how long the requested window may be.

Value in: 60 | 3600 | 86400
kindRequiredstring

Stream kind to return. stt covers Speech-to-Text WebSocket sessions, tts covers Text-to-Speech WebSocket streams and REST requests.

Accepted values: "stt" | "tts"

Response

200

Per-period concurrent stream aggregates.

kindRequiredstring

Stream kind these entries describe (stt or tts).

Value in: "stt" | "tts"
entriesRequiredarray<object>

Per-period concurrent stream aggregates for the authenticated project, ordered by period_start ascending. Every aggregation period in the requested window is returned, with no gaps. Periods with no recorded activity have every field set to 0.

Errors

Per-period concurrent stream aggregates.

{
  "kind": "tts",
  "entries": [
    {
      "period_start": "2026-04-28T09:00:00Z",
      "period_sec": 60,
      "sample_min": 0,
      "sample_max": 4,
      "sample_sum": 21,
      "sample_count": 9,
      "total_count": 1
    },
    {
      "period_start": "2026-04-28T09:01:00Z",
      "period_sec": 60,
      "sample_min": 0,
      "sample_max": 0,
      "sample_sum": 0,
      "sample_count": 0,
      "total_count": 0
    }
  ]
}