Messagesv2

Get message status

GET/chats/{chatId}/messages/{messageId}/status

Get delivery status for a specific message.

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.

messageIdRequiredstring

Unique identifier of the message, prefixed with msg_ (e.g. msg_abc123def456). Returned in the response when you send a message and in inbound message webhooks.

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

message_idoptionalstring

chat_idoptionalstring

directionoptionalstring

"inbound""outbound"

statusoptionalstring

"pending""queued""sent""delivered""failed""cancellation_requested""cancelled"

protocoloptionalstring

"imessage""sms""rcs""non-imessage"

time_sentoptionalinteger

time_deliveredoptionalinteger | null

erroroptionalstring | null

Response codes

200Message status

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

Response objectexample

{  "message_id": "msg_a1b2c3d4",  "chat_id": "chat_a1b2c3d4",  "direction": "inbound",  "status": "pending",  "protocol": "imessage",  "time_sent": 0,  "time_delivered": 0,  "error": "string"}