These three read-only endpoints show what sits in your Power Dialer: the lists and who owns them, every contact queued across the account, and one agent's queue. Use them to report on call queues, or to find a list's ID before you add to it or clear it with the Power Dialer API.
- Method: GET
- Auth: your account API token, in the query string as
api_token or in the Authorization header - Format: JSON out
- Paging: by cursor. Send
meta.next_cursor back as cursor until it comes back null.
List the Power Dialer lists
Every list in the account, with the agent who owns it. Every agent has a default list called "My Queue". A list whose type_name is synced is kept in sync with an integration such as HubSpot, so contacts can't be added to it through the API.
GET /api/v1/webhook/powerdialer-lists
| api_token | Required. Your Aloware API token. |
| user_id | Optional. Only the lists this agent owns. |
| search | Optional. Only lists whose name contains this text. |
| per_page | Optional. Results per page, from 1 to 500. Default 100. |
| cursor | Optional. The meta.next_cursor value from the page before. |
curl --location --request GET 'https://app.aloware.io/api/v1/webhook/powerdialer-lists?api_token=[API_TOKEN]&user_id=1' \
--header 'Accept: application/json'
200: the lists
{
"data": [
{
"id": 50,
"name": "My Queue",
"type": 1,
"type_name": "static",
"is_default_queue_list": true,
"user": {
"id": 1,
"name": "John Agent",
"email": "john@example.com"
},
"created_at": "2026-08-17T12:00:00.000000Z"
}
],
"links": {
"first": null,
"last": null,
"prev": null,
"next": null
},
"meta": {
"path": "/api/v1/webhook/powerdialer-lists",
"per_page": 100,
"next_cursor": null,
"prev_cursor": null
}
}
A user_id that doesn't exist returns 404, and an invalid field returns 422.
List one agent's queue
The contacts in the lists one agent owns: what the Power Dialer screen shows that agent. An agent with nothing queued gets an empty list, not an error.
GET /api/v1/webhook/powerdialer-user-contacts
| api_token | Required. Your Aloware API token. |
| user_id | Required. The agent's user ID. |
| contact_id | Optional. Only this contact's assignment. |
| task_status | Optional. 1 queued, 2 in progress, 3 completed, 4 failed, 5 scheduled. |
| per_page | Optional. Results per page, from 1 to 500. Default 100. |
| cursor | Optional. The meta.next_cursor value from the page before. |
curl --location --request GET 'https://app.aloware.io/api/v1/webhook/powerdialer-user-contacts?api_token=[API_TOKEN]&user_id=1&task_status=1' \
--header 'Accept: application/json'
200: the agent's queue
{
"data": [
{
"contact_list_item_id": 987654,
"contact": {
"id": 44500,
"name": "Jane Doe",
"first_name": "Jane",
"last_name": "Doe",
"phone_number": "+13105551234",
"email": "jane@example.com"
},
"user": {
"id": 1,
"name": "John Agent",
"email": "john@example.com"
},
"contact_list": {
"id": 50,
"name": "My Queue",
"is_default_queue_list": true
},
"task_status": 1,
"task_status_name": "queued",
"order": 10,
"task_scheduled_at": null,
"created_at": "2026-08-17T12:00:00.000000Z"
}
],
"meta": {
"per_page": 100,
"next_cursor": null,
"prev_cursor": null
}
}
This goes by who owns the list. Clearing a user's lists with the Power Dialer API goes by who added each contact, so the two can differ when an admin adds contacts for an agent.
List every queued contact
All contacts assigned to a Power Dialer anywhere in the account, each with the agent whose list it sits in. Same row shape as the agent's queue above. Accounts can hold hundreds of thousands of assignments, so page through with the cursor.
GET /api/v1/webhook/powerdialer-contacts
| api_token | Required. Your Aloware API token. |
| user_id | Optional. Only this agent's assignments. |
| contact_id | Optional. Only this contact's assignments. |
| task_status | Optional. 1 queued, 2 in progress, 3 completed, 4 failed, 5 scheduled. |
| per_page | Optional. Results per page, from 1 to 500. Default 100. |
| cursor | Optional. The meta.next_cursor value from the page before. |
curl --location --request GET 'https://app.aloware.io/api/v1/webhook/powerdialer-contacts?api_token=[API_TOKEN]&task_status=1&per_page=500' \
--header 'Accept: application/json'
A contact_id that doesn't exist returns 404, and an invalid field returns 422. User IDs come from the Users API.
Put your own Aloware API token in place of [API_TOKEN].
Need another endpoint?
For other API functions or any question about this one, email support@aloware.com with what you're trying to do.