Chatsv2

List chats

GET/chats

List all unique conversations for the organization, sorted by most recent message.

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

limitoptionalinteger

Maximum number of items to return in a single response. Must be between 1 and 200; defaults to 50. Use together with offset to page through large result sets.

offsetoptionalinteger

Number of items to skip before returning results. Combine with limit for page-based pagination (e.g. offset=50&limit=50 returns the second page). Defaults to 0.

qoptionalstring

Search query (matches phone/email or contact name)

sortoptionalstring

Sort order

"recent""oldest"

Returns

chatsoptionalChat[]

Array of Chat

idoptionalstring

Chat identifier (phone number, email, or group ID)

typeoptionalstring

"phone""email""group"

is_groupoptionalboolean

Whether this is a group chat

group_idoptionalstring | null

Group ID (only for group chats)

group_nameoptionalstring | null

Group name (only for group chats)

member_countoptionalinteger

Number of members (only for group chats)

contactoptionalobject | null

Contact info (only for non-group chats)

contact_idoptionalstring

nameoptionalstring | null

identifieroptionalstring

message_countoptionalinteger

inbound_countoptionalinteger

outbound_countoptionalinteger

background_urloptionalstring | null

Public URL of the chat background image (if one has been set via the API)

background_idoptionalstring | null

Identifier for the active chat background

last_message_timeoptionalinteger

last_inbound_timeoptionalinteger | null

last_outbound_timeoptionalinteger | null

last_messageoptionalLastMessage

message_idoptionalstring

textoptionalstring | null

directionoptionalstring

"inbound""outbound"

time_sentoptionalinteger

paginationoptionalPagination

limitoptionalinteger

offsetoptionalinteger

totaloptionalinteger

Response codes

200List of chats

401Authentication required or invalid

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/v2/api/chats?limit=50&offset=0&q=string&sort=recent \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "chats": [    {      "id": "chat_a1b2c3d4",      "type": "phone",      "is_group": true,      "group_id": "grp_a1b2c3d4",      "group_name": "string",      "member_count": 3,      "contact": {        "contact_id": "ct_a1b2c3d4",        "name": "Jane Doe",        "identifier": "+15551234567"      },      "message_count": 3,      "inbound_count": 3,      "outbound_count": 3,      "background_url": "https://example.com",      "background_id": "chat_a1b2c3d4",      "last_message_time": 0,      "last_inbound_time": 0,      "last_outbound_time": 0,      "last_message": {        "message_id": "msg_a1b2c3d4",        "text": "Hello from Blooio!",        "direction": "inbound",        "time_sent": 0      }    }  ],  "pagination": {    "limit": 50,    "offset": 1,    "total": 3  }}