---
title: Streams CLI reference
description: List Honeybadger Insights data streams and their IDs from the command line.
url: https://docs.honeybadger.io/resources/cli/streams/
---

The `streams` command lists the [Insights streams](https://docs.honeybadger.io/guides/insights/#streams) for a project.

Stream IDs are what you use to scope an [Insights query](https://docs.honeybadger.io/resources/cli/insights/) to specific streams (`hb insights query --stream-ids`) and to point an [alarm](https://docs.honeybadger.io/resources/cli/alarms/) at the right data — `stream_ids` is required when creating or updating an alarm.

## List streams

```shell
hb streams list --project-id 12345
```

The table output lists each stream’s ID, name, slug, whether it’s the internal stream, and when it was created.

**Required flags:**

* `--project-id` — Project ID

**Optional flags:**

* `-o, --output` — Output format: `table` or `json` (default: `table`)

---

## Try Honeybadger for FREE

Intelligent logging, error tracking, and Just Enough APM™ in one dev-friendly platform. Find and fix problems before users notice.

[Start free trial](https://app.honeybadger.io/users/sign_up)

[See plans and pricing](https://www.honeybadger.io/plans/)