# Replace example resource IDs and ownerId with values from your workspace.
: "${POWERDIALER_API_KEY:?Set POWERDIALER_API_KEY to your scoped API key}"
curl --request GET \
--url 'https://api.migration.powerdialer.ai/api/public/v2/lists/456' \
--header "Authorization: Bearer $POWERDIALER_API_KEY"{
"name": "October inbound leads",
"ownerId": "user_example",
"groupName": "Inbound",
"id": 456,
"orgId": "org_example",
"createdAt": "2026-10-08T12:00:00.000Z",
"updatedAt": "2026-10-08T12:00:00.000Z",
"contactsCount": 1
}{
"error": {
"code": "invalid_api_key",
"message": "API key is invalid, expired or revoked",
"requestId": "00000000-0000-4000-8000-000000000004"
}
}Get a calling list
Read the current name, owner, group and contact count for a calling list, for example before displaying a campaign in your integration. Requires lists:read. Use the numeric ID returned when the list was created or listed; list names do not uniquely identify records.
The key must permit the list’s workspace and owner. The response contains list details, not embedded contacts. To enumerate members, use GET /lists/{id}/contacts with both list-read and contact-read permission. Its visible contact page can be smaller than the list’s total contact count because contact ownership is checked separately.
A 404 not_found means the list is missing or inaccessible. For 400 invalid_request, supply a positive numeric ID; for 403 insufficient_scope, use a key with list-read permission. This read needs no idempotency key and can be retried after transient failures.
See calling lists.
# Replace example resource IDs and ownerId with values from your workspace.
: "${POWERDIALER_API_KEY:?Set POWERDIALER_API_KEY to your scoped API key}"
curl --request GET \
--url 'https://api.migration.powerdialer.ai/api/public/v2/lists/456' \
--header "Authorization: Bearer $POWERDIALER_API_KEY"{
"name": "October inbound leads",
"ownerId": "user_example",
"groupName": "Inbound",
"id": 456,
"orgId": "org_example",
"createdAt": "2026-10-08T12:00:00.000Z",
"updatedAt": "2026-10-08T12:00:00.000Z",
"contactsCount": 1
}{
"error": {
"code": "invalid_api_key",
"message": "API key is invalid, expired or revoked",
"requestId": "00000000-0000-4000-8000-000000000004"
}
}Authorizations
Issued in Developers. Workspace/owner/scopes come from credential, never acting-user headers. API keys cannot manage API credentials.
Path Parameters
Numeric calling-list ID returned by POST /lists or GET /lists. The list must be visible to this credential.
1 <= x <= 2147483647Response
Current details and total membership count for the visible calling list.
PowerDialer list ID. Use this integer in list URLs and analytics filters.
Calling-list display name.
PowerDialer member who owns this list.
Workspace identifier stored on the list.
Optional grouping label, or null.
List creation time in UTC.
Last list update time in UTC.
Stored total membership count for the list. It may exceed the contacts visible to a restricted key.