Chatsv4

List chats

GET/chats

Lists conversations, most recent first. Filter by channel type, state, channel, or contact.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Query parameters

typeoptionalChannelType

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

stateoptionalChatState

"open""closed""blocked""deprecated"

channel_idoptionalstring

contact_idoptionalstring

limitoptionalinteger

Maximum number of items to return per page. Must be between 1 and 200; defaults to 50. Combine with cursor to paginate.

cursoroptionalstring

Opaque pagination cursor. Pass the next_cursor value from a previous response to fetch the next page; omit it on the first request.

Returns

dataoptionalChat[]

Array of Chat

idoptionalstring

Chat id (chat_...).

channel_idoptionalstring

channel_typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

contact_idoptionalstring | null

identity_idoptionalstring | null

group_idoptionalstring | null

stateoptionalstring

"open""closed""blocked""deprecated"

capabilitiesoptionalobject

window_expires_atoptionalinteger | null

last_message_atoptionalinteger | null

created_atoptionalinteger

has_moreoptionalboolean

next_cursoroptionalstring | null

Response codes

200A page of chats

400The request was malformed — check the path, query parameters, and body.

401Your API key is missing or invalid. Pass it as a bearer token.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X GET https://api.blooio.com/v4/chats?type=blooio&state=open&channel_id=ch_a1b2c3d4&contact_id=ct_a1b2c3d4&limit=50&cursor=string \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "data": [    {      "id": "chat_a1b2c3d4",      "channel_id": "ch_a1b2c3d4",      "channel_type": "blooio",      "contact_id": "ct_a1b2c3d4",      "identity_id": "idn_a1b2c3d4",      "group_id": "grp_a1b2c3d4",      "state": "open",      "capabilities": {},      "window_expires_at": 0,      "last_message_at": 0,      "created_at": 0    }  ],  "has_more": true,  "next_cursor": "string"}