Lister les listes noires
/v1/accounts/{accountId}/blackListsRenvoie les listes noires 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 noires ayant l’un des ID indiqués.
{"ids":["BLACK_LIST_ID_1","BLACK_LIST_ID_2"]}Listes noires dont le nom contient le texte (insensible à la casse).
{"name":"do not call"}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 noire 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: blackLists 0-9/57. Consultez Pagination.
/v1/accounts/ACCOUNT_ID/blackLists
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/blackLists' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'filter={"name":"call"}' \
--data-urlencode 'sort=["name","ASC"]' \
--data-urlencode 'range=[0,99]'Réponse
200 OK
[
{
"id": "01a0dedd-b9a2-729d-8e0a-4e3ad9197aea",
"name": "Do Not Call",
"numbersCount": 3,
"updatedAt": "2026-09-26T17:57:48.064"
},
{
"id": "01a0dad2-c0a6-7205-8d4e-a2d5f4197825",
"name": "National DNC Registry",
"numbersCount": 18452,
"updatedAt": "2026-09-25T23:09:37.921"
}
]
