Listar números de lista de contactos

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

Devuelve los números de una lista de contactos, opcionalmente filtrados y ordenados.

Parámetros de ruta

accountIduuidObligatorio

ID de tu cuenta de SIP Caller. Consulta ID de la cuenta.

contactListIduuidObligatorio

ID de la lista de contactos.

Parámetros de consulta

filterJSON object

Condiciones que deben cumplir los registros, como {"name":"sales"}. Consulta los Campos de filtro más abajo, y Filtro para ver la sintaxis.

sortJSON array

Campo y dirección usados para ordenar los registros, como ["id","DESC"]. El valor predeterminado es ["id","ASC"]. Consulta Ordenamiento.

rangeJSON array

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.

numberstring

Números que contienen el texto, lo que permite búsquedas parciales.

Ejemplo: {"number":"18035551"}
varValuesobject

Números cuya variable contiene el texto (sin distinguir mayúsculas de minúsculas). La clave es $ seguido de la posición de la variable, comenzando en 1.

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

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 id en orden ascendente.

idnumber

Devuelve

Devuelve un array de objetos número de lista de contactos 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: contactListNumbers 0-9/57. Consulta Paginación.

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]'

Respuesta

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 los Derechos Reservados
LinkedinYou Tube
Trustpilot