Listar números da lista de contatos

GET/v1/accounts/{accountId}/contactLists/{contactListId}/numbers

Retorna os números de uma lista de contatos, opcionalmente filtrados e ordenados.

Parâmetros de caminho

accountIduuidObrigatório

ID da sua conta SIP Caller. Consulte ID da conta.

contactListIduuidObrigatório

ID da lista de contatos.

Parâmetros de query string

filterJSON object

Condições que os registros devem atender, como {"name":"sales"}. Consulte os Campos de filtro abaixo, e Filtro para a sintaxe.

sortJSON array

Campo e direção usados para ordenar os registros, como ["id","DESC"]. O padrão é ["id","ASC"]. Consulte Ordenação.

rangeJSON array

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.

numberstring

Números que contêm o texto, o que permite buscas parciais.

Exemplo: {"number":"18035551"}
varValuesobject

Números cuja variável contém o texto (sem diferenciar maiúsculas e minúsculas). A chave é $ seguido da posição da variável, começando em 1.

Exemplo: {"varValues":{"$1":"watson"}}

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 id em ordem crescente.

idnumber

Retorna

Retorna um array de objetos número de lista de contatos 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: contactListNumbers 0-9/57. Consulte Paginação.

GET

/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers

curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers' \ -H 'Authorization: Bearer API_KEY_TOKEN' \ --data-urlencode 'filter={"number":"18035551"}' \ --data-urlencode 'sort=["id","DESC"]' \ --data-urlencode 'range=[0,99]'

Resposta

200 OK

[ { "id": 8, "number": "+18035551005", "varValues": [ "Millie Watson", "$118.49" ] }, { "id": 7, "number": "+18035551004", "varValues": [ "Stefan Robertson", "$99.00" ] }, { "id": 6, "number": "+18035551003", "varValues": [ "Clara White", "$350.00" ] } ]


SIP Caller
© 2026 Easy Caller LLC Todos os direitos reservados
LinkedinYou Tube
Trustpilot