Listar números da lista negra
/v1/accounts/{accountId}/blackLists/{blackListId}/numbersRetorna os números de uma lista negra, opcionalmente filtrados e ordenados.
Parâmetros de caminho
ID da sua conta SIP Caller. Consulte ID da conta.
ID da lista negra.
Parâmetros de query string
Condições que os registros devem atender, como {"name":"sales"}. Consulte os Campos de filtro abaixo, e Filtro para a sintaxe.
Campo e direção usados para ordenar os registros, como ["number","DESC"]. O padrão é ["number","ASC"]. Consulte Ordenação.
Posições, começando em zero, do primeiro e do último registro a retornar, ambos incluídos, como [0,99]. O padrão é [0,9]. Consulte Paginação.
Campos de filtro
Campos que podem ser usados no parâmetro de query string filter. Consulte Filtro para a sintaxe geral.
Números que contêm o texto, o que permite buscas parciais.
{"number":"555010"}Campos de ordenação
Campos que podem ser usados no parâmetro de query string sort, em ordem crescente (ASC) ou decrescente (DESC). Consulte Ordenação para a sintaxe geral. Quando sort é omitido, os resultados são ordenados por number em ordem crescente.
numberidRetorna
Retorna um array de objetos número de lista negra para a página solicitada. Os cabeçalhos X-Total-Count e Content-Range contêm o número total de registros que atendem ao filtro, por exemplo Content-Range: blackListNumbers 0-9/57. Consulte Paginação.
/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]'Resposta
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"
}
]
