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

# Get conversation

> Retrieve a conversation's details by its ID.

# Get conversation

Returns the details of a specific conversation, including the handoff summary when applicable.

```http theme={null}
GET https://app.chatnorris.ai/api/v2/conversations/{conversation_id}
Authorization: Bearer <your_api_key>
```

**Required scope:** `conversations:read`

***

## Path parameters

| Parameter | Type | Description |
| - | - | - |
| `conversation_id` | string | Conversation ID |

***

## Response

```json theme={null}
{
  "status": "success",
  "data": {
    "id": "conv_abc123",
    "chatbot_id": "bot_xyz789",
    "visitor_id": "visitor_001",
    "visitor_name": "Juan Pérez",
    "visitor_email": "juan@empresa.com",
    "status": "closed",
    "channel": "web",
    "handoff_summary": "The customer asked about refunds. They say they didn't receive the money from their June 10 return.",
    "created_at": "2026-06-28T14:00:00.000Z",
    "updated_at": "2026-06-28T14:35:00.000Z"
  }
}
```

### Response fields

| Field | Type | Description |
| - | - | - |
| `id` | string | Unique ID of the conversation |
| `chatbot_id` | string | Agent ID |
| `visitor_id` | string | Visitor identifier |
| `visitor_name` | string \| null | Visitor's name |
| `visitor_email` | string \| null | Visitor's email |
| `status` | string | Status: `bot`, `handoff`, `open` or `closed` |
| `channel` | string | Channel: `web`, `whatsapp`, `instagram`, `telegram`, `messenger`, `email` or `api` (conversations created with the API) |
| `handoff_summary` | string \| null | AI-generated summary when the conversation is escalated to a human agent |
| `created_at` | string | Start date (ISO 8601) |
| `updated_at` | string | Latest activity (ISO 8601) |

***

## Common errors

| Code | Description |
| - | - |
| `NOT_FOUND` | The conversation doesn't exist or doesn't belong to your organization |


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