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

<CodeGroup>
  ```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()
  ```
</CodeGroup>

## 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).
</Note>