Listar listas de contactos
/v1/accounts/{accountId}/contactListsDevuelve las listas de contactos 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 de contactos con cualquiera de los IDs indicados.
{"ids":["CONTACT_LIST_ID_1","CONTACT_LIST_ID_2"]}Listas de contactos cuyo nombre contiene el texto (sin distinguir mayúsculas de minúsculas).
{"name":"overdue"}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 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: contactLists 0-9/57. Consulta Paginación.
/v1/accounts/ACCOUNT_ID/contactLists
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'filter={"name":"overdue"}' \
--data-urlencode 'sort=["name","ASC"]' \
--data-urlencode 'range=[0,99]'Respuesta
200 OK
[
{
"id": "019ffc4b-1c59-72ed-b15a-cbf81a2b95d9",
"name": "Overdue Accounts",
"numbersCount": 1255,
"varNames": [
"Customer Name",
"Due Balance"
],
"updatedAt": "2026-08-13T18:03:28.729"
}
]
