Listar listas negras
/v1/accounts/{accountId}/blackListsDevuelve las listas negras de la cuenta, opcionalmente filtradas y ordenadas.
Parámetros de ruta
ID de tu cuenta de SIP Caller. Consulta ID de la cuenta.
Parámetros de consulta
Condiciones que deben cumplir los registros, como {"name":"sales"}. Consulta los Campos de filtro más abajo, y Filtro para ver la sintaxis.
Campo y dirección usados para ordenar los registros, como ["name","DESC"]. El valor predeterminado es ["name","ASC"]. Consulta Ordenamiento.
Posiciones, comenzando en cero, del primer y del último registro a devolver, ambos incluidos, como [0,99]. El valor predeterminado es [0,9]. Consulta Paginación.
Campos de filtro
Campos que se pueden usar en el parámetro de consulta filter. Consulta Filtro para ver la sintaxis general.
Listas negras con cualquiera de los IDs indicados.
{"ids":["BLACK_LIST_ID_1","BLACK_LIST_ID_2"]}Listas negras cuyo nombre contiene el texto (sin distinguir mayúsculas de minúsculas).
{"name":"do not call"}Campos de ordenamiento
Campos que se pueden usar en el parámetro de consulta sort, en orden ascendente (ASC) o descendente (DESC). Consulta Ordenamiento para ver la sintaxis general. Cuando se omite sort, los resultados se ordenan por name en orden ascendente.
namenumbersCountDevuelve
Devuelve un array de objetos lista negra para la página solicitada. Los encabezados X-Total-Count y Content-Range contienen la cantidad total de registros que cumplen el filtro, por ejemplo Content-Range: blackLists 0-9/57. Consulta Paginación.
/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]'Respuesta
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"
}
]
