---
title: "List streams"
method: GET
path: "/v1/streams"
tags: ["Streams"]
---

# List streams

`GET /v1/streams`

## Request

- Base URL: `https://api.sonovault.now`
- URL: `https://api.sonovault.now/v1/streams`
- Auth: API key in header `x-api-key`

List the streams you've registered (active and stopped), newest first.

**Requires a paid plan**: the free tier returns `403` for this endpoint.

## Response `200`

Successful response

- object
  - `streams` Stream[], required: Your streams, active and stopped, newest first.
    - `id` string, required: Stream ID (UUID). Every other stream endpoint takes it.
    - `url` string, required: The audio stream URL being monitored.
    - `name` string, nullable, required: Your label for the stream. `null` when you did not set one.
    - `status` 'active' | 'stopped', required: `active` while monitored and billed, `stopped` after you stop it.
    - `detection_mode` 'precise' | 'balanced' | 'broad', required: The accuracy/coverage target the matcher tunes toward.
    - `outage_notifications` boolean, required: Whether we email you when this stream goes down and when it recovers. Defaults to `true`; toggle it with `PATCH /v1/streams/:id`.
    - `created_at` string, required: When the stream was registered, ISO-8601 UTC.
    - `stopped_at` string, nullable, required: When it was stopped, ISO-8601 UTC. `null` while active.

---

[API](https://skmtc.dev/sonovault/apis/sonovault-api.md) · [All operations](https://skmtc.dev/sonovault/apis/sonovault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonovault/apis/sonovault-api/revisions/0152fff23f2c?raw)