Skip to main content
GET
/
v1
/
api
/
messages
/
{messageId}
Get message details
curl --request GET \
  --url https://backend.blooio.com/v1/api/messages/{messageId} \
  --header 'Authorization: Bearer <token>'
{
  "message_id": "gK2Ig_XGR2M6UkSgmT9FK",
  "api_key": "VTAsewjhLz4KUcf3rt8tu",
  "external_id": "+15551234567",
  "direction": "outbound",
  "text_length": 23,
  "attachments_count": 0,
  "time_sent": 1703123457370,
  "status": "delivered",
  "metadata": {
    "ticket_id": "TCK-123"
  },
  "protocol": "imessage"
}

Authorizations

​
Authorization
string
header
required

API key must be provided in the Authorization header as Bearer YOUR_API_KEY.

Path Parameters

​
messageId
string
required

Unique identifier for the message returned by the API.

Response

Message metadata and current status.

​
message_id
string
​
organization_id
string

Organization ID that owns this message.

​
external_id
string

Recipient phone number or email.

​
direction
enum<string>
Available options:
outbound,
inbound
​
text_length
integer
​
attachments_count
integer
​
time_sent
integer

Unix timestamp (ms) when the message was queued/sent.

​
status
enum<string>

Current delivery status.

Available options:
pending,
queued,
sent,
delivered,
failed,
cancelled,
cancellation_requested
​
metadata
object

Original metadata provided plus system generated fields.

​
protocol
string

The protocol used to send the message (e.g., imessage, rcs, sms).

Example:

"imessage"