Skip to main content
GET
/
ds
/
{bucket}
/
streams
curl 'https://stream.tonbo.dev/ds/demo/streams'

{
  "bucket_id": "demo",
  "prefix": "",
  "stream_count": 2,
  "streams": [
    {
      "stream_id": "hello",
      "status": "open",
      "content_type": "application/json",
      "tail_offset": 42,
      "created_at_ms": 1711234567890,
      "last_write_at_ms": 1711234599000
    }
  ],
  "next_cursor": "hello",
  "has_more": false
}
​
bucket
string
required
Bucket ID. Must match [a-z0-9_-]{4,64}.
​
prefix
string
default:""
Only return streams whose ID starts with this prefix.
​
after
string
Cursor for pagination. Return streams after this stream ID.
​
limit
number
default:"1000"
Maximum number of streams to return. Must be between 1 and 1000.

​
Response

StatusMeaning
200Streams listed.
400Invalid bucket ID or limit out of range.
404Bucket not found.
​
bucket_id
string
required
The bucket identifier.
​
prefix
string
required
The prefix filter applied.
​
stream_count
number
required
Number of streams in this page.
​
streams
object[]
required
​
next_cursor
string
Cursor for the next page. Pass as after to fetch the next page.
​
has_more
boolean
required
Whether more streams exist beyond this page.
curl 'https://stream.tonbo.dev/ds/demo/streams'

{
  "bucket_id": "demo",
  "prefix": "",
  "stream_count": 2,
  "streams": [
    {
      "stream_id": "hello",
      "status": "open",
      "content_type": "application/json",
      "tail_offset": 42,
      "created_at_ms": 1711234567890,
      "last_write_at_ms": 1711234599000
    }
  ],
  "next_cursor": "hello",
  "has_more": false
}