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

# Get agents

`GET /ccaas/1/agents`

## 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/agents`
- 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 agents with pagination and filtering options. Using a 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/get-started" target="_blank">More info</a>

## Query parameters

- `agentIds` string[]
- `queueIds` string[]
- `displayName` string
- `email` string, email
- `status` 'ACTIVE' | 'BUSY' | 'INVISIBLE' | 'AWAY'
- `availability` 'ACTIVE' | 'BUSY' | 'INVISIBLE' | 'AWAY'
- `role` 'AGENT' | 'SUPERVISOR'
- `enabled` boolean
- `createdAfter` string, date-time
- `createdBefore` string, date-time
- `updatedAfter` string, date-time
- `updatedBefore` string, date-time
- `limit` integer
- `page` integer
- `orderBy` string

## Response `200`

OK

- 59fee77911b10cc32daa4aa3591d8ca0b6f5fe540a80b499aee90c38ff11a187AgentResponseResultPage
  - `agents` 59fee77911b10cc32daa4aa3591d8ca0b6f5fe540a80b499aee90c38ff11a187AgentResponse[]
    - `id` string: Agent ID.
    - `displayName` string, required: Agent name to be displayed.
    - `title` string
    - `status` 'ACTIVE' | 'BUSY' | 'INVISIBLE' | 'AWAY': Agent availability.
    - `availability` 'ACTIVE' | 'BUSY' | 'INVISIBLE' | 'AWAY': Agent availability.
    - `role` 'AGENT' | 'SUPERVISOR': Agent role.
    - `enabled` boolean: Agent enabled/disabled toggle.
    - `createdAt` string, date-time: Time stamp when agent is created.
    - `updatedAt` string, date-time: Time stamp when agent is last updated.
  - `pagination` 59fee77911b10cc32daa4aa3591d8ca0b6f5fe540a80b499aee90c38ff11a187Pagination
    - `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)