Chatsv2

Get a chat

GET/chats/{chatId}

Get details for a specific conversation.

Path parameters

chatIdRequiredstring

Chat identifier. Can be: (1) phone number in E.164 format (e.g., +15551234567), (2) email address, (3) group ID (grp_xxxx), or (4) comma-separated list of phone numbers/emails for multi-recipient group chats (e.g., +15551234567,+15559876543). All values should be URL-encoded.

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

Returns

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

first_message_timeoptionalinteger

last_message_timeoptionalinteger

last_inbound_timeoptionalinteger | null

last_outbound_timeoptionalinteger | null

last_messageoptionalLastMessage

message_idoptionalstring

textoptionalstring | null

directionoptionalstring

"inbound""outbound"

time_sentoptionalinteger

Response codes

200Chat details

400Invalid request parameters

401Authentication required or invalid

404Resource not found

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/chat_a1b2c3d4 \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "id": "obj_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": "obj_a1b2c3d4",  "first_message_time": 0,  "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  }}