---
title: "Retrieve call queue agent"
method: GET
path: "/call_queues/{id}/agents/{agent_number}"
tags: ["Call Queue"]
---

# Retrieve call queue agent

`GET /call_queues/{id}/agents/{agent_number}`

## Request

- Base URL: `https://HOSTNAME:8887/api`
- URL: `https://HOSTNAME:8887/api/call_queues/{id}/agents/{agent_number}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/docs/call_queues/:id/agents/:agent_number/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve information of call queue agent.

## Path parameters

- `id` string, required: The unique ID of the resource.
- `agent_number` string, required: The extension number.

## Response `200`

OK

- object
  - `extension_number` string: The extension number.
  - `display_name` string: The display name of user.
  - `skill_level` integer: The skill level of agent in queue. Only valid when `polling_strategy` is skill based.
  - `status` 'READY' | 'NOT_READY' | 'QUEUE_CALL' | 'OTHER_CALL' | 'WRAP_UP' | 'BREAK' | 'LUNCH' | 'LOGGED_OUT' | 'OFFLINE': Current status of agent: - `READY`: - `NOT_READY`: - `QUEUE_CALL`: - `OTHER_CALL`: - `WRAP_UP`: - `BREAK`: - `LUNCH`: - `TRANSFER`: - `CONSULT_TRANSFER`: - `ON_HOLD`: - `LOGGED_OUT`: - `OFFLINE`:

## Other responses

- `4XX`: Error

---

[API](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api.md) - [All operations](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/revisions/577415d4a3d5?raw)