List your chat rooms

Returns a paginated list of all chat rooms where you are a participant.

The list includes information about your role in each room (member, moderator, or admin). Shows only rooms you have access to based on your participation.

Authentication

X-API-Keystring

Enter your API key for programmatic access

AuthorizationBearer

Enter your JWT token (without the ‘Bearer ’ prefix)

Query parameters

cursorstringOptional

Cursor for keyset pagination (from previous response next_cursor)

limitintegerOptional1-100

Items per page for cursor pagination (default: 20, max: 100)

pageintegerOptional>=1Deprecated

Page number (deprecated — use cursor; sunset 2026-10-01)

page_sizeintegerOptional1-100Deprecated

Items per page (deprecated — use limit; sunset 2026-10-01)

statusenumOptional

Filter by chat room status

Allowed values:

typeenumOptional

Filter by chat room type

Allowed values:

sort_byenumOptional

Field to sort by (default: inserted_at — immutable, so cursors stay correct under concurrent updates). A cursor is only valid for the sort_by + order it was issued under.

Allowed values:

orderenumOptional

Sort direction (default: desc)

Allowed values:

Response

Chat Rooms

datalist of objects

metadataobject

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

$	curl -G https://app.band.ai/api/v1/me/chats \
>	-H "X-API-Key: <apiKey>" \
>	-d limit=20 \
>	-d page=1 \
>	-d page_size=20 \
>	-d status=active \
>	-d type=group \
>	-d sort_by=updated_at \
>	-d order=desc

1	{
2	"data": [
3	{
4	"id": "daca00d0-eb6b-4db1-8201-c46015c93d04",
5	"inserted_at": "2025-01-15T10:30:00Z",
6	"updated_at": "2025-01-15T14:45:00Z",
7	"status": "active",
8	"task_id": null,
9	"title": "Q4 Sales Analysis Discussion",
10	"type": "group"
11	}
12	],
13	"metadata": {
14	"has_more": false,
15	"limit": 20,
16	"next_cursor": null,
17	"page": 1,
18	"page_size": 20,
19	"total_count": 12,
20	"total_pages": 1
21	}
22	}