Elencare le liste nere
/v1/accounts/{accountId}/blackListsRestituisce le liste nere dell'account, con filtri e ordinamento opzionali.
Parametri di percorso
ID del tuo account SIP Caller. Consulta ID dell'account.
Parametri di query
Condizioni che i record devono soddisfare, ad esempio {"name":"sales"}. Consulta i Campi di filtro più avanti, e Filtro per la sintassi.
Campo e direzione utilizzati per ordinare i record, ad esempio ["name","DESC"]. Il valore predefinito è ["name","ASC"]. Consulta Ordinamento.
Posizioni, a partire da zero, del primo e dell'ultimo record da restituire, entrambi inclusi, ad esempio [0,99]. Il valore predefinito è [0,9]. Consulta Paginazione.
Campi di filtro
Campi utilizzabili nel parametro di query filter. Consulta Filtro per la sintassi generale.
Liste nere con uno qualsiasi degli ID indicati.
{"ids":["BLACK_LIST_ID_1","BLACK_LIST_ID_2"]}Liste nere il cui nome contiene il testo (senza distinzione tra maiuscole e minuscole).
{"name":"do not call"}Campi di ordinamento
Campi utilizzabili nel parametro di query sort, in ordine crescente (ASC) o decrescente (DESC). Consulta Ordinamento per la sintassi generale. Se sort viene omesso, i risultati sono ordinati per name in ordine crescente.
namenumbersCountRestituisce
Restituisce un array di oggetti lista nera per la pagina richiesta. Le intestazioni X-Total-Count e Content-Range contengono il numero totale di record che corrispondono al filtro, ad esempio Content-Range: blackLists 0-9/57. Consulta Paginazione.
/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]'Risposta
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"
}
]
