> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reachedapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an SMS Message

> Retrieves the full details of a specific SMS message by its ID.

# Get an SMS Message

Retrieves the full details of a specific SMS message by its ID.

## Request

`GET /v1/sms-messages/:id`

### Path Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | uuid | Yes | The SMS message ID |

## Example

```bash cURL theme={null}
curl -X GET \
  https://kdjmltmhxvvmiuehafgl.supabase.co/functions/v1/api-gateway/v1/sms-messages/msg-uuid-1 \
  -H "Authorization: Bearer rchd_live_xxxxxxxxxxxx"
```

```javascript JavaScript theme={null}
const messageId = "msg-uuid-1";
const response = await fetch(
  `https://kdjmltmhxvvmiuehafgl.supabase.co/functions/v1/api-gateway/v1/sms-messages/${messageId}`,
  { headers: { "Authorization": "Bearer rchd_live_xxxxxxxxxxxx" } }
);
const { data } = await response.json();
```

```python Python theme={null}
import requests

response = requests.get(
    "https://kdjmltmhxvvmiuehafgl.supabase.co/functions/v1/api-gateway/v1/sms-messages/msg-uuid-1",
    headers={"Authorization": "Bearer rchd_live_xxxxxxxxxxxx"}
)
data = response.json()
```

## Response

```json theme={null}
{
  "data": {
    "id": "msg-uuid-1",
    "lead_id": "a1b2c3d4-...",
    "from_number": "+33140000000",
    "to_number": "+33612345678",
    "body": "Hi John, following up on our call last week.",
    "direction": "outbound",
    "status": "delivered",
    "segment_count": 2,
    "twilio_message_sid": "SMxxxxxxx",
    "read_at": null,
    "created_at": "2026-09-14T10:00:00.000Z"
  }
}
```

### Response Fields

| Field | Type | Description |
| - | - | - |
| `id` | uuid | Message unique identifier |
| `lead_id` | uuid | Associated lead ID (if linked) |
| `from_number` | string | Sender phone number |
| `to_number` | string | Recipient phone number |
| `body` | string | Message content |
| `direction` | string | `inbound` (received) or `outbound` (sent) |
| `status` | string | Delivery status |
| `segment_count` | integer | Number of SMS segments used |
| `twilio_message_sid` | string | Twilio message SID (if applicable) |
| `read_at` | datetime | Timestamp when the message was marked as read |
| `created_at` | datetime | Message creation timestamp |

> [!NOTE]
>
> The message will only be returned if it belongs to your workspace. Requests for messages from another workspace will return a 404 error.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.