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

# List the streams

`GET /v1/streams`

## Request

- Base URL: `https://api.sendora.se`
- URL: `https://api.sendora.se/v1/streams`
- Auth: HTTP bearer

Every stream of the server, archived ones included, oldest first.

## Response `200`

Every stream of the server, archived ones included, oldest first.

- object: Every stream of the server, archived ones included, oldest first.
  - `streams` object[], required
    - `streamId` string, uuid, required: What a send names as streamId.
    - `kind` 'transactional' | 'broadcast' | 'inbound', required: transactional for mail the recipient expects; broadcast for mail to many; inbound for mail the server receives.
    - `name` string, required: The name given at creation, unique within the server.
    - `isDefault` boolean, required: The stream a send without a streamId goes on; one per server, transactional.
    - `createdAt` string, date-time, required
    - `archivedAt` string, date-time, nullable, required: Set once archived; the stream then takes no new messages.
    - `pausedAt` string, date-time, nullable, required: Set while Sendora has paused the stream after complaints; it takes no messages until support has resumed it.
    - `inboundAddress` string, nullable, required: The address of an inbound stream, its id on inbound.sendora.se; mail sent there is received on the stream. Null on every other kind.
    - `contentRetentionDays` integer, nullable, required: How many days an inbound stream keeps received content, 1 to 30; null means the default of 30. Null on every other kind.

## Other responses

- `401`: The key is missing, malformed or revoked.
- `403`: The key is of the other kind, or a connected app may not do this here: it is not for connections, the connection may only read here, or it is for test servers only.

---

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