---
title: "Get message details"
method: GET
path: "/v1/api/messages/{messageId}"
tags: ["Messages"]
---

# Get message details

`GET /v1/api/messages/{messageId}`

Retrieve full message metadata including direction, protocol, text length, attachments count, timestamps, current status, and original metadata.

## Response `200`

Message metadata and current status.

- MessageDetails
  - `message_id` string
  - `api_key` string
  - `external_id` string — Recipient phone number.
  - `direction` 'outbound' | 'inbound'
  - `text_length` integer
  - `attachments_count` integer
  - `time_sent` integer — Unix timestamp (ms) when the message was queued/sent.
  - `status` 'pending' | 'queued' | 'sent' | 'delivered' | 'failed' | 'cancelled' | 'cancellation_requested' — Current delivery status.
  - `metadata` object — Original metadata provided plus system generated fields.
  - `protocol` string — The protocol used to send the message (e.g., imessage, rcs, sms).

## Other responses

- `401` — Invalid or missing API key.
- `404` — Resource not found.

---

[API](https://skmtc.dev/blooio/apis/blooio-messaging-api-v3.md) · [All operations](https://skmtc.dev/blooio/apis/blooio-messaging-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blooio/blooio-messaging-api-v3/revisions/2d1e4d94ef5b/schema)