# Conversations: Get a conversation (https://docs.envocal.ai/api-reference/conversations/get-a-conversation/)

> Who talked to which agent and when, the transcript, the summary and how it ended.

## GET `/v1/tenants/{tenantId}/conversations/{id}`

Who talked to which agent and when, the transcript, the summary and how it ended.

**Required permission:** `conversations:read`

### Parameters

| Name | In | | Type | Description |
| --- | --- | --- | --- | --- |
| `tenantId` | path | required | string | Tenant id, or `current` for the key's own tenant. Must be the key's tenant or one of its sub-tenants. |
| `id` | path | required | string | Conversation id. |

### Responses

**200** — PublicConversationDto: The conversation.

| Field | Type | | Description |
| --- | --- | --- | --- |
| `id` | string | required | Conversation id. |
| `tenantId` | string | required | Tenant the conversation belongs to. |
| `agentId` | string | nullable | Agent that handled it; null if the agent was deleted since. |
| `agentName` | string | nullable | Agent name at the time of the conversation. |
| `channel` | string | nullable | `phone`, `voice_chat` (web voice, including text chats upgraded to voice) or `text_chat` (web text). Older data may contain `text_voice_chat`. |
| `startUtc` | string (date-time) | nullable | Start time (UTC). |
| `endUtc` | string (date-time) | nullable | End time (UTC). |
| `duration` | integer | nullable | Length in seconds. |
| `endReason` | string | nullable | Why the conversation ended (e.g. caller hung up, AI ended the call). |
| `agentPhoneNumber` | string | nullable | Number the caller dialled (phone), E.164. |
| `userPhoneNumber` | string | nullable | Caller's number (phone), E.164. |
| `summary` | string | nullable | Summary generated after the conversation, in the conversation's language. |
| `result` | string | nullable | Outcome label, if set. |
| `topic` | string | nullable | Short topic (1–2 words), generated after the conversation. |
| `sentiment` | string | nullable | Sentiment label, if set. |
| `successCriteria` | string | nullable | Success criteria evaluation, if set. |
| `messages` | integer |  | Number of messages in `transcript`. |
| `transcript` | PublicTranscriptMessageDto[] | required | What was said, in order: the visitor's or caller's messages and the agent's. The agent's tool calls are not included. |

**401**: Missing, invalid, revoked or expired API key.

**403**: The key lacks the required permission, or the tenant/resource is outside its reach.

**404**: Not found in this tenant.

**429**: Rate limit exceeded. Retry after the number of seconds in the Retry-After header.

### Example

```bash
curl -X GET "https://api.envocal.ai/v1/tenants/current/conversations/{id}" \
  -H "Authorization: Bearer evk_eu_..."
```