Passer au contenu principal
GET
/
v2
/
api
/
dialing-queues
/
current
Get current queue
curl --request GET \
  --url https://api.withallo.com/v2/api/dialing-queues/current \
  --header 'Authorization: <api-key>'
{
  "data": {
    "id": "pdl_2xGh7kLmNpQr",
    "name": "My Queue",
    "creator_id": "usr_abc123",
    "assignee_id": "usr_abc123",
    "numbers": [
      {
        "number_to": "+12125550010",
        "position": 0,
        "created_at": "2026-04-30T10:00:00",
        "updated_at": "2026-04-30T10:00:00"
      }
    ],
    "created_at": "2026-04-30T10:00:00",
    "updated_at": "2026-04-30T10:00:00"
  }
}

Cibler la file d’un coequipier

Par defaut, cet endpoint retourne la file assignee au proprietaire de la cle API. Pour inspecter la file d’un coequipier, passez user_id ou email en query parameter. Le coequipier doit appartenir a la meme equipe que le proprietaire de la cle API.
  • user_id — l’emporte quand les deux sont fournis. Resolvez les ids des coequipiers via GET /v2/api/users.
  • email — utilise uniquement quand user_id est absent.
Si l’utilisateur resolu n’est pas dans votre equipe, la reponse est 404 ASSIGNEE_NOT_FOUND — la meme erreur est renvoyee que l’utilisateur n’existe pas ou ne soit pas un coequipier, afin que les consommateurs de l’API ne puissent pas enumerer les utilisateurs.

Autorisations

Authorization
string
header
requis

Paramètres de requête

user_id
string

ID of a teammate to read the queue for. Resolve teammate ids via GET /v2/api/users. Wins over email when both are provided.

Exemple:

"usr-15BB68317A7F06F0C07A3BBD8F244102A6872220"

email
string<email>

Email of a teammate to read the queue for. Ignored when user_id is also supplied.

Réponse

The targeted user's Power Dialer queue

data
object

A user's Power Dialer queue with its configuration and numbers.