---
title: List K2 streams
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[K2](https://developers.cloudflare.com/api/resources/k2)
[Streams](https://developers.cloudflare.com/api/resources/k2/subresources/streams)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# List K2 streams
GET/accounts/{account\_id}/k2/streams
List or filter K2 streams in an account.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### P ath ParametersExpand Collapse
account\_id: string
Specifies the public ID of the account.
maxLength32
minLength32
[Link to this property](<#(resource)%20k2.streams%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
##### Q uery ParametersExpand Collapse
name: optional string
Filters K2 streams by name using a case-insensitive substring.
maxLength128
minLength1
[Link to this property](<#(resource)%20k2.streams%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>)
page: optional number
minimum1
[Link to this property](<#(resource)%20k2.streams%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>)
per\_page: optional number
maximum100
minimum1
[Link to this property](<#(resource)%20k2.streams%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: array of object {message, code }
message: string
Link to this property
code: optional number
Link to this property
[Link to this property](<#(resource)%20k2.streams%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {message, code }
message: string
Link to this property
code: optional number
Link to this property
[Link to this property](<#(resource)%20k2.streams%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: array of object {id, created\_at, endpoint, 5 more }
id: string
Specifies the public ID of the K2 stream.
maxLength32
minLength32
Link to this property
created\_at: string
formatdate-time
Link to this property
endpoint: string
Indicates the base HTTP endpoint for producing and consuming records.
formaturi
Link to this property
http: object {enabled, authentication, cors }
Configures the HTTP endpoint. Disabling HTTP keeps authentication and cors, so enabling it again restores them.
enabled: boolean
Indicates whether the HTTP endpoint accepts records.
Link to this property
authentication: optional boolean
Indicates whether the HTTP endpoint requires an API token with K2 produce permission. When false, the endpoint accepts unauthenticated records. Defaults to true when HTTP is enabled without a stored value.
Link to this property
cors: optional object {origins }
origins: optional array of string
Allows browser requests from these HTTP or HTTPS origins. Use a wildcard only as the sole origin. An empty list blocks cross-origin browser requests. Defaults to ['*'] when HTTP is enabled without stored origins.
Link to this property
Link to this property
Link to this property
modified\_at: string
formatdate-time
Link to this property
name: string
Indicates the name of the K2 stream.
maxLength128
minLength1
Link to this property
retention\_seconds: number
Shows the configured record retention period from 1 hour (3600 seconds) to 30 days (2592000 seconds), inclusive.
maximum2592000
minimum3600
Link to this property
worker\_binding: object {enabled }
enabled: boolean
Indicates whether Workers bindings can produce records to the stream.
Link to this property
Link to this property
[Link to this property](<#(resource)%20k2.streams%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
result\_info: object {count, page, per\_page, total\_count }
count: number
Link to this property
page: number
Link to this property
per\_page: number
Link to this property
total\_count: number
Link to this property
[Link to this property](<#(resource)%20k2.streams%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>)
success: boolean
Indicates whether the API call was successful.
[Link to this property](<#(resource)%20k2.streams%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### List K2 streams
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/k2/streams \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```
200 example
```
{
"errors": [
{
"message": "message",
"code": 0
}
],
"messages": [
{
"message": "message",
"code": 0
}
],
"result": [
{
"id": "053e105f4ecef8ad9ca31a8372d0c353",
"created_at": "2019-12-27T18:11:19.117Z",
"endpoint": "https://053e105f4ecef8ad9ca31a8372d0c353.k2.cloudflarestorage.com",
"http": {
"enabled": true,
"authentication": true,
"cors": {
"origins": [
"string"
]
}
},
"modified_at": "2019-12-27T18:11:19.117Z",
"name": "my_k2_stream",
"retention_seconds": 604800,
"worker_binding": {
"enabled": true
}
}
],
"result_info": {
"count": 0,
"page": 0,
"per_page": 0,
"total_count": 0
},
"success": true
}
```
##### Returns Examples
200 example
```
{
"errors": [
{
"message": "message",
"code": 0
}
],
"messages": [
{
"message": "message",
"code": 0
}
],
"result": [
{
"id": "053e105f4ecef8ad9ca31a8372d0c353",
"created_at": "2019-12-27T18:11:19.117Z",
"endpoint": "https://053e105f4ecef8ad9ca31a8372d0c353.k2.cloudflarestorage.com",
"http": {
"enabled": true,
"authentication": true,
"cors": {
"origins": [
"string"
]
}
},
"modified_at": "2019-12-27T18:11:19.117Z",
"name": "my_k2_stream",
"retention_seconds": 604800,
"worker_binding": {
"enabled": true
}
}
],
"result_info": {
"count": 0,
"page": 0,
"per_page": 0,
"total_count": 0
},
"success": true
}
```