API reference

Get a message

Returns the full message record plus a timestamped event timeline (queued → sending → sent → delivered, or any failure path).

GET/v1/admin/messages/:id

Request

bash

curl https://api-raven-cloud.autotribes.app/v1/admin/messages/$MESSAGE_ID \
  -H "Authorization: Bearer eyJ..." \
  -H "X-App-Name: raven-cloud" \
  -H "X-Tenant-Slug: acme-co"

Response

json

{
  "id": "8ad4f7c2-9e3b-4a1c-bc2f-1d8e3a9b7c4d",
  "channel": "sms",
  "source": "api",
  "to": "+254722000000",
  "body": "Hi Ada, your order #AC-1042 is on its way.",
  "status": "delivered",
  "providerMessageId": "ATXid_a1b2c3d4",
  "costCurrency": "KES",
  "costAmount": 0.8,
  "sentAt": "2026-05-01T10:23:18.302Z",
  "deliveredAt": "2026-05-01T10:23:21.882Z",
  "createdAt": "2026-05-01T10:23:18.114Z",
  "events": [
    { "eventType": "sent", "providerEventId": "ATXid_a1b2c3d4",
      "providerPayload": { "SMSMessageData": { "Recipients": [...] } },
      "occurredAt": "2026-05-01T10:23:18.302Z" }
  ]
}

The same endpoint exists at GET /v1/messages/:id for API key auth.