Listar números de lista negra
/v1/accounts/{accountId}/blackLists/{blackListId}/numbersDevuelve los números de una lista negra, opcionalmente filtrados y ordenados.
Parámetros de ruta
ID de tu cuenta de SIP Caller. Consulta ID de la cuenta.
ID de la lista negra.
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 ["number","DESC"]. El valor predeterminado es ["number","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.
Números que contienen el texto, lo que permite búsquedas parciales.
{"number":"555010"}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 number en orden ascendente.
numberidDevuelve
Devuelve un array de objetos número de 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: blackListNumbers 0-9/57. Consulta Paginación.
/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]'Respuesta
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"
}
]
