List streams
GET/api/streams
List streams
Request
Query Parameters
- On a date
- Greater than
- Lower than
Possible values: <= 100
Default value: 100
The number of items to include in the response.
Default value: 0
The offset of the first returned item.
Filter items by the updated_at field. This is in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
Filter items updated on a date.
Example: 2024-01-01T20:00:00%2B02:00
Filter items updated after a date.
Example: gt:2024-01-01T20:00:00%2B02:00
Filter items updated before a date.
Example: lt:2024-01-01T20:00:00%2B02:00
Whether to filter archived streams or not.
Possible values: [streamLeaders, streamMembers]
Comma separated list of relations to include in the response.
Keyword to search for in the stream name.
Header Parameters
The company you want to interact with
The API version you want to use
Responses
- 200
- 400
- 401
- 403
- 412
Returns the list of streams set for the company.
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
]
Array [
]
]
Possible values: >= 1
The unique identifier of the resource
The date and time when the resource was created
The date and time when the resource was last updated
Possible values: <= 255 characters
The stream name
Whether this stream is the default one
The date and time when the resource was archived
stream_leaders
object[]
The list of stream leaders associated with this stream
Possible values: >= 1
The unique identifier of the resource
The date and time when the resource was created
The date and time when the resource was last updated
Possible values: >= 1
The ID of the stream
Possible values: >= 1
The ID of the person attached to the stream as leader
The date and time when the resource was deleted
stream_members
object[]
The list of stream members associated with this stream
Possible values: >= 1
The unique identifier of the resource
The date and time when the resource was created
The date and time when the resource was last updated
Possible values: >= 1
The ID of the stream
Possible values: >= 1
The ID of the person attached to the stream as member
The start date of the association
The end date of the association
[
{
"id": 1,
"created_at": "2026-01-09T17:32:14.565Z",
"updated_at": "2026-01-09T17:32:14.565Z",
"name": "Developers",
"is_default": false,
"archived_at": "2026-01-09T17:32:14.565Z",
"stream_leaders": [
{
"id": 1,
"created_at": "2026-01-09T17:32:14.565Z",
"updated_at": "2026-01-09T17:32:14.565Z",
"stream_id": 1,
"leader_id": 1,
"deleted_at": "2026-01-09T17:32:14.565Z"
}
],
"stream_members": [
{
"id": 1,
"created_at": "2026-01-09T17:32:14.565Z",
"updated_at": "2026-01-09T17:32:14.565Z",
"stream_id": 1,
"member_id": 1,
"starts_at": "2026-01-09",
"ends_at": "2026-01-09"
}
]
}
]
Validation failed
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Error unique key
Human-readable message describing the error
failures
object[]
List of validation errors
Name of the field causing the error
Human-readable description of the error
{
"key": "invalid_data",
"message": "You provided invalid data. Check 'failures' for details.",
"failures": [
{
"field": "string",
"message": "string"
}
]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
"key": "string",
"message": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
"key": "string",
"message": "string"
}
Precondition failed
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
"key": "precondition_failure",
"message": "string"
}