List agent summaries in domain

GET

/domains/{domain}/agents/list

Last modified:2026-10-09 00:26:42

OperationId:ListDomainAgents

Lists every call queue agent entry in the domain in a reduced form: who the agent is, the first queue they are on, their priority there, their dispatch state, and the user's name, site, and department. One row per agent.

Call Center Supervisor, Office Manager, Route Manager, Reseller, and Super User list every agent in the domain (Reseller within its territory), and Office Manager Read-Only and Super User Read Only list the same. Site Manager lists agents who are users at its own site. Call Center Agent, Basic User, Advanced User, and Simple User see only their own agent entries: their user and each of their devices. Rows you may not see are left out.

Wrap-up, dispatch tuning, and live call counts are on GET /domains/{domain}/agents. start and limit page the rows; limit defaults to 100.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

The agent entries. An empty array when the domain has none.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//agents/list?start=undefined&limit=100' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Agent picker

[
    {
        "callqueue-agent-id": "1001@example.com",
        "callqueue": "4000",
        "domain": "example.com",
        "callqueue-agent-dispatch-queue-priority-ordinal": 1,
        "callqueue-agent-entry-type": "user",
        "callqueue-agent-availability-for-dispatch": "available",
        "name-full-name": "Front Desk",
        "site": "Main Office",
        "agent-department": "Sales"
    },
    {
        "callqueue-agent-id": "sip:1002wp@example.com",
        "callqueue": "4000",
        "domain": "example.com",
        "callqueue-agent-dispatch-queue-priority-ordinal": 1,
        "callqueue-agent-entry-type": "device",
        "callqueue-agent-availability-for-dispatch": "unavailable",
        "name-full-name": "Support Line",
        "site": "Main Office",
        "agent-department": "Support"
    }
]

Modified at 2026-10-09 00:26:42

Count agents in domain

List agent summaries in call queue