---
title: "Get information about a stream"
method: GET
path: "/storage/streams/{name}"
tags: ["Streams"]
---

# Get information about a stream

`GET /storage/streams/{name}`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/storage/streams/{name}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-5/docs/storage/streams/:name/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves detailed information about a specific stream, including its configuration and current state. This endpoint provides metrics such as the number of messages, bytes used, first and last sequence numbers, and more.

## Path parameters

- `name` string, required

## Response `200`

Successfully retrieved stream information

- StreamResponse
  - `body` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2025-07-04** `d566a61279be`: 6 warning, 5 info
  - deleted the `query` request parameter `subject`
  - removed the optional property `body/cluster` from the response with the `200` status
  - removed the optional property `body/config` from the response with the `200` status
  - removed the optional property `body/created` from the response with the `200` status
  - …7 more
- **2025-06-13** `e4ad9e1ccd66`: 5 warning, 2 info
  - removed the optional property `cluster` from the response with the `200` status
  - removed the optional property `config` from the response with the `200` status
  - removed the optional property `created` from the response with the `200` status
  - removed the optional property `state` from the response with the `200` status
  - …3 more
- **2025-05-22** `72fe48f81978`: 3 breaking, 3 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `404`
  - added the optional property `error` to the response with the `400` status
  - …2 more

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-5/changes/storage/streams/:name/get.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-5.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-5/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-5/revisions/104591eadd10?raw)