# 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?limit=50' \
--header "Authorization: Bearer $POWERDIALER_API_KEY"{
"data": [
{
"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
}
],
"nextCursor": null
}{
"error": {
"code": "invalid_api_key",
"message": "API key is invalid, expired or revoked",
"requestId": "00000000-0000-4000-8000-000000000004"
}
}List calling lists
Find the calling lists available to your integration before assigning contacts or reporting on list performance. Requires lists:read. Personal keys see their owner’s lists; workspace keys see lists within their configured owner restrictions. Names are display labels and need not be unique, so retain each numeric list ID.
Results are ordered by increasing ID and include name, owner, group and contact count. Follow nextCursor with after until it is null. Pagination is not a snapshot: reconcile concurrent list changes through the change feed when maintaining a local copy.
A successful empty page means no currently visible lists. 400 invalid_request indicates an invalid cursor, page size or unsupported filter; 403 insufficient_scope means this key cannot read lists. Reads can be retried after transient errors without an idempotency key.
# 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?limit=50' \
--header "Authorization: Bearer $POWERDIALER_API_KEY"{
"data": [
{
"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
}
],
"nextCursor": null
}{
"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.
Query Parameters
Exclusive numeric ID cursor. Omit or use 0 for the first page, then pass the previous nextCursor. Keep the same filters while paging.
0 <= x <= 2147483647Maximum items to return in one page, from 1 to 200. Defaults to 50. Smaller pages reduce response size; this is not a total-result limit.
1 <= x <= 200