Lister les numéros d’une liste noire
/v1/accounts/{accountId}/blackLists/{blackListId}/numbersRenvoie les numéros d’une liste noire, éventuellement filtrés et triés.
Paramètres de chemin
ID de votre compte SIP Caller. Consultez ID du compte.
ID de la liste noire.
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 ["number","DESC"]. Par défaut : ["number","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.
Numéros qui contiennent le texte, ce qui permet les recherches partielles.
{"number":"555010"}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 number en ordre croissant.
numberidRenvoie
Renvoie un tableau d’objets numéro de 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: blackListNumbers 0-9/57. Consultez Pagination.
/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'filter={"number":"555010"}' \
--data-urlencode 'sort=["number","DESC"]' \
--data-urlencode 'range=[0,99]'Réponse
200 OK
[
{
"id": 3,
"number": "+18005550103",
"description": "Asked not to be called again"
},
{
"id": 2,
"number": "+18005550102",
"description": null
},
{
"id": 1,
"number": "+18005550101",
"description": "Customer request, 2026-09-12"
}
]
