Messages

Get a message

One message by id.

GET/v1/messages/{message_id}

Needs the messages:read scope.

Path parameters

message_idstringrequired

Message id

Returns

The message. A failed call answers with an error instead.

idstring

createdAtstring

directionstring

inbound | outbound.

fromstring

mediaMediaResource[]

numberIdstring

statusstring

textstring

tostring

curl https://api.ringhouse.ai/v1/messages/{message_id} \
  -H "Authorization: Bearer rh_live_xxxxxxxx"

{
  "id": "8c1d4e7a-5b2f-4a90-9e1c-3f7d2b6a1c08",
  "createdAt": "2026-09-25T14:02:11Z",
  "direction": "inbound",
  "from": "+447700900123",
  "media": [
    {
      "contentType": "image/jpeg",
      "url": "https://files.ringhouse.ai/media/8c1d4e7a/photo.jpg"
    }
  ],
  "numberId": "e41b09c2-77d3-4c5e-b0a8-9d2f61c4e3a7",
  "status": "completed",
  "text": "Is my table ready for eight?",
  "to": "+441134960000"
}

Was this page helpful?

Previous← Send a message NextList calls