> ## 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 Conversation

> Retrieves a single SMS conversation by its ID, including the full message history.

# Get an SMS Conversation

Retrieves a single SMS conversation by its ID, including the full message history (up to 200 most recent messages in chronological order).

## Request

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

### Path Parameters

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

## Example

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

```javascript JavaScript theme={null}
const conversationId = "conv-uuid-1";
const response = await fetch(
  `https://kdjmltmhxvvmiuehafgl.supabase.co/functions/v1/api-gateway/v1/sms-conversations/${conversationId}`,
  { headers: { "Authorization": "Bearer rchd_live_xxxxxxxxxxxx" } }
);
const { data } = await response.json();
// data.messages contains the full message history (up to 200 messages)
```

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

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

## Response

```json theme={null}
{
  "data": {
    "id": "conv-uuid-1",
    "lead_id": "a1b2c3d4-...",
    "contact_phone": "+33612345678",
    "company_phone": "+33140000000",
    "contact_name": "John Doe",
    "last_message_body": "Sounds good, let's talk tomorrow at 2pm.",
    "last_message_at": "2026-09-14T11:30:00.000Z",
    "last_message_direction": "inbound",
    "unread_count": 2,
    "created_at": "2026-09-14T10:00:00.000Z",
    "messages": [
      {
        "id": "msg-uuid-1",
        "direction": "outbound",
        "from_number": "+33140000000",
        "to_number": "+33612345678",
        "body": "Hi John, following up on our call last week.",
        "status": "delivered",
        "segment_count": 1,
        "created_at": "2026-09-14T10:00:00.000Z"
      },
      {
        "id": "msg-uuid-2",
        "direction": "inbound",
        "from_number": "+33612345678",
        "to_number": "+33140000000",
        "body": "Sounds good, let's talk tomorrow at 2pm.",
        "status": "received",
        "segment_count": 1,
        "created_at": "2026-09-14T11:30:00.000Z"
      }
    ]
  }
}
```

### Response Fields

| Field | Type | Description |
| - | - | - |
| `id` | uuid | Conversation unique identifier |
| `lead_id` | uuid | Associated lead ID (if linked) |
| `contact_phone` | string | The contact's phone number |
| `company_phone` | string | Your company phone number used in the conversation |
| `contact_name` | string | Name of the contact (if known) |
| `last_message_body` | string | Content of the most recent message |
| `last_message_at` | datetime | Timestamp of the most recent message |
| `last_message_direction` | string | Direction of the most recent message |
| `unread_count` | integer | Number of unread inbound messages |
| `created_at` | datetime | Conversation creation timestamp |
| `messages` | array | Full message history (up to 200 messages, oldest first) |

> [!NOTE]
>
> The conversation will only be returned if it belongs to your workspace. Requests for conversations from another workspace will return a 404 error. The `messages` array contains up to 200 most recent messages sorted chronologically (oldest first).


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