Messages

Get a message

Current documentation

Fetch a message and its delivery status.

GET https://beam.aisync.link/v1/messages/:id

curl https://beam.aisync.link/v1/messages/41 \
  -H "x-api-key: YOUR_WORKSPACE_KEY"

{
  "id": "41",
  "direction": "outbound",
  "channel": "imessage",
  "body": "Hey Sarah, you are booked for Tuesday at 2. See you then!",
  "status": "sent",
  "from_number": "+15559876543",
  "attachments": [],
  "sent_at": "2026-08-21T15:04:11.000Z",
  "created_at": "2026-08-21T15:01:02.000Z"
}

Statuses

Status	Meaning
`queued`	Accepted, waiting in the pacing queue.
`sent`	Handed to the network. `channel` tells you blue bubble or text.
`delivered`	Delivery confirmed against carrier records (texts and blue bubbles).
`failed`	The send did not go through.
`cancelled`	You cancelled it before it went out.
`no_channel`	No active number could reach this contact.

The real success signal is the replyDelivery statuses are useful, but the metric that matters is whether people answer. Watch the reply rate in your inbox header.