Messages
List messages in a chat
List all messages in a conversation with optional filtering.
Authorization
BearerAuth AuthorizationBearer <token>
API key authentication. Use your API key as the bearer token.
In: header
Path Parameters
chatId*string
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.
Query Parameters
limit?integer
Maximum number of items to return (1-200)
Default
50Range
1 <= value <= 200offset?integer
Number of items to skip
Default
0Range
0 <= valuesort?string
Sort order by time
Default
"desc"Value in
"asc" | "desc"direction?string
Filter by message direction
Value in
"inbound" | "outbound"since?integer
Only messages sent after this timestamp (ms)
Format
int64until?integer
Only messages sent before this timestamp (ms)
Format
int64Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://backend.blooio.com/v2/api/chats/%2B15551234567/messages"{
"chat_id": "string",
"messages": [
{
"message_id": "string",
"direction": "inbound",
"external_id": "string",
"text": "string",
"attachments": [
{}
],
"sender": "string",
"time_sent": 0,
"time_delivered": 0,
"status": "pending",
"protocol": "imessage",
"error": "string"
}
],
"pagination": {
"limit": 0,
"offset": 0,
"total": 0
}
}{
"error": "string",
"status": 0
}{
"error": "string",
"status": 0
}{
"error": "string",
"status": 0
}