List agents in call queue

Lists a call queue's agents with their queue settings, live state, and the name, department, and site of the user behind each one.

Call Center Supervisor, Office Manager, Route Manager, Reseller, and Super User read every agent in the domain (Reseller within its territory), and Office Manager Read-Only and Super User Read Only read the same. Site Manager reads 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, so a scope limited to its own entries gets only those.

Rows are sorted by callqueue-agent-id and paged with start and limit, which defaults to 100. A queue that does not exist returns 404. For names only, call GET /domains/{domain}/callqueues/{callqueue}/agents/list; for a total, .../agents/count.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//callqueues//agents?callqueue-agent-availability-for-dispatch=available&callqueue-agent-availability-type=automatic&start=undefined&limit=100' \ --header 'Authorization: Bearer <token>'

[ { "callqueue": "4000", "domain": "example.com", "callqueue-agent-id": "1001@example.com", "name-full-name": "Front Desk", "callqueue-agent-availability-type": "automatic", "callqueue-agent-availability-for-dispatch": "available", "auto-answer-enabled": "no", "callqueue-agent-wrap-up-allowance-seconds": 10, "callqueue-agent-has-registered-devices": "yes", "callqueue-agent-dispatch-order-ordinal": 1, "callqueue-agent-dispatch-queue-priority-ordinal": 1, "limits-max-active-calls-total": 1, "callqueue-agent-answer-confirmation-enabled": "no", "active-calls-total-current": 0, "callqueue-agent-max-concurrent-sms-conversations": 0, "last-callqueue-dispatch-datetime": "2026-09-01T14:30:00+00:00", "last-modified-datetime": "2026-09-01T14:32:10+00:00", "callqueue-agent-entry-type": "user", "login-username": "1001@example.com", "name-first-name": "Front", "name-last-name": "Desk", "agent-department": "Sales", "site": "Main Office", "user-scope": "Call Center Agent", "status-message": "" }, { "callqueue": "4000", "domain": "example.com", "callqueue-agent-id": "sip:1002wp@example.com", "name-full-name": "Support Line", "callqueue-agent-availability-type": "manual", "callqueue-agent-availability-for-dispatch": "unavailable", "auto-answer-enabled": "no", "callqueue-agent-wrap-up-allowance-seconds": 10, "callqueue-agent-has-registered-devices": "yes", "callqueue-agent-dispatch-order-ordinal": 2, "callqueue-agent-dispatch-queue-priority-ordinal": 1, "limits-max-active-calls-total": 1, "callqueue-agent-answer-confirmation-enabled": "no", "active-calls-total-current": 0, "callqueue-agent-max-concurrent-sms-conversations": 0, "last-callqueue-dispatch-datetime": null, "last-modified-datetime": "2026-09-01T14:32:10+00:00", "callqueue-agent-entry-type": "device", "login-username": "1002@example.com", "name-first-name": "Support", "name-last-name": "Line", "agent-department": "Sales", "site": "Main Office", "user-scope": "Call Center Agent", "status-message": "Lunch" } ]

Request

Responses