OtherAPI 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>

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).

Accepted values: "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
    }
  ]
}