# Conversations: List conversations of a tenant (https://docs.envocal.ai/api-reference/conversations/list-conversations-of-a-tenant/)

> Newest first, paged. Combine the filters as needed. Get one conversation for its transcript and summary.

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

Newest first, paged. Combine the filters as needed. Get one conversation for its transcript and summary.

**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. |
| `agentName` | query |  | string | Only conversations whose agent name contains this text. |
| `channels` | query |  | string[] | Only these channels; repeat the parameter for several (`?channels=phone&channels=text_chat`). Values: `phone`, `voice_chat`, `text_chat` (older data may contain `text_voice_chat`). |
| `startFrom` | query |  | string (date-time) | Only conversations that started at or after this time (ISO 8601). |
| `startTo` | query |  | string (date-time) | Only conversations that started at or before this time (ISO 8601). |
| `page` | query |  | integer | Page number, starting at 1. |
| `pageSize` | query |  | integer | Items per page, 1–200. Default 10. |

### Responses

**200** — PublicConversationListItemDtoPagedResult: One page of conversations.

| Field | Type | | Description |
| --- | --- | --- | --- |
| `items` | PublicConversationListItemDto[] | required | The items on this page. |
| `page` | integer |  | Page number, starting at 1. |
| `pageSize` | integer |  | Items per page. |
| `totalCount` | integer |  | Total number of items across all pages. |

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

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

**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" \
  -H "Authorization: Bearer evk_eu_..."
```