Lister les listes de contacts
/v1/accounts/{accountId}/contactListsRenvoie les listes de contacts du compte, éventuellement filtrées et triées.
Paramètres de chemin
ID de votre compte SIP Caller. Consultez ID du compte.
Paramètres de requête
Conditions auxquelles les enregistrements doivent répondre, par exemple {"name":"sales"}. Consultez les Champs de filtre ci-dessous, et Filtrage pour la syntaxe.
Champ et sens utilisés pour trier les enregistrements, par exemple ["name","DESC"]. Par défaut : ["name","ASC"]. Consultez Tri.
Positions, commençant à zéro, du premier et du dernier enregistrement à renvoyer, tous deux inclus, par exemple [0,99]. Par défaut : [0,9]. Consultez Pagination.
Champs de filtre
Champs utilisables dans le paramètre de requête filter. Consultez Filtrage pour la syntaxe générale.
Listes de contacts ayant l’un des ID indiqués.
{"ids":["CONTACT_LIST_ID_1","CONTACT_LIST_ID_2"]}Listes de contacts dont le nom contient le texte (insensible à la casse).
{"name":"overdue"}Champs de tri
Champs utilisables dans le paramètre de requête sort, en ordre croissant (ASC) ou décroissant (DESC). Consultez Tri pour la syntaxe générale. Lorsque sort est omis, les résultats sont triés par name en ordre croissant.
namenumbersCountRenvoie
Renvoie un tableau d’objets liste de contacts pour la page demandée. Les en-têtes X-Total-Count et Content-Range contiennent le nombre total d’enregistrements correspondant au filtre, par exemple Content-Range: contactLists 0-9/57. Consultez Pagination.
/v1/accounts/ACCOUNT_ID/contactLists
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'filter={"name":"overdue"}' \
--data-urlencode 'sort=["name","ASC"]' \
--data-urlencode 'range=[0,99]'Réponse
200 OK
[
{
"id": "019ffc4b-1c59-72ed-b15a-cbf81a2b95d9",
"name": "Overdue Accounts",
"numbersCount": 1255,
"varNames": [
"Customer Name",
"Due Balance"
],
"updatedAt": "2026-08-13T18:03:28.729"
}
]
