---
title: "Get conversations"
method: GET
path: "/ccaas/1/conversations"
tags: ["customer-engagement", "conversations", "conversation-management"]
---

# Get conversations

`GET /ccaas/1/conversations`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/ccaas/1/conversations`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Use this method to get a list of conversations with pagination and filtering option. Using the filter is optional. The result can be filtered by one or many optional filters described in parameters. <a href="https://www.infobip.com/docs/conversations-api" target="_blank">More info</a>

## Query parameters

- `conversationIds` string[]
- `queueIds` string[]
- `tagNames` string[]
- `agentId` string
- `status` 'OPEN' | 'WAITING' | 'SOLVED' | 'CLOSED'
- `priority` 'URGENT' | 'HIGH' | 'NORMAL' | 'LOW'
- `createdAfter` string, date-time
- `createdBefore` string, date-time
- `updatedAfter` string, date-time
- `updatedBefore` string, date-time
- `closedAfter` string, date-time
- `closedBefore` string, date-time
- `limit` integer
- `page` integer
- `orderBy` string

## Response `200`

OK

- E89661b226e518f36a162935afcdf1132c95b0e63e9c86c5ef5f31c5a8d865a2ConversationResultPage
  - `conversations` E89661b226e518f36a162935afcdf1132c95b0e63e9c86c5ef5f31c5a8d865a2ConversationApiModel[]
    - `id` string: Conversation Id.
    - `topic` string: Conversation topic.
    - `summary` string: Short description of the conversation.
    - `status` 'OPEN' | 'WAITING' | 'SOLVED' | 'CLOSED': Conversation status.
    - `priority` 'URGENT' | 'HIGH' | 'NORMAL' | 'LOW': Conversation priority.
    - `queueId` string: Id of the queue conversation belongs to.
    - `agentId` string: Id of the agent assigned to the conversation.
    - `createdAt` string, date-time: Time stamp when conversation is created.
    - `updatedAt` string, date-time: Time stamp when conversation is updated.
    - `closedAt` string, date-time: If conversation is closed, time stamp when is closed.
  - `pagination` E89661b226e518f36a162935afcdf1132c95b0e63e9c86c5ef5f31c5a8d865a2Pagination
    - `totalItems` integer
    - `page` integer
    - `limit` integer
    - `orderBy` string

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)