Listar llamadas

POST /v3/list-calls

Devuelve una lista paginada de llamadas con soporte para filtros avanzados. Los filtros pueden combinarse para consultas muy específicas: por agente, estado, número, dirección, fechas, duración, sentimiento del usuario y más.

Nota: Este endpoint usa POST (no GET) para permitir filtros complejos en el cuerpo de la solicitud.

---

Parámetros del cuerpo (todos opcionales)

Campo	Tipo	Predeterminado	Máximo	Descripción
filter_criteria	object	—	—	Criterios de filtrado (se aplican con lógica AND).
sort_order	string	descending	—	Ordena por start_timestamp. Valores: ascending | descending
limit	integer	50	1000	Cantidad máxima de registros a retornar.
skip	integer	0	—	Registros a omitir. No se puede usar junto con pagination_key.
pagination_key	string	—	—	Cursor opaco obtenido de una respuesta anterior. No se puede usar junto con skip.

---

Filtros disponibles (filter_criteria)

Todos los filtros son opcionales y se combinan con lógica AND.

Filtro por agente

"agent": [
  { "agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD" },
  { "agent_id": "otro_agent_id", "version": [1, 2] }
]

Múltiples agentes se combinan con lógica OR.

Filtros de texto (StringFilter)

Aplican a: call_id, batch_call_id, from_number, to_number

Operador	Descripción
eq	Igual a
ne	Distinto de
sw	Comienza con
ew	Termina con
co	Contiene

Ejemplo:

"from_number": { "operator": "eq", "value": "[phone]" }

Filtros de enumeración (EnumFilter)

Aplican a: call_status, call_type, direction, user_sentiment, disconnection_reason, data_storage_setting

"direction": { "operator": "eq", "value": "outbound" }

"call_status": { "operator": "eq", "value": "ended" }

Valores disponibles por campo:

Campo	Valores
call_status	not_connected | ongoing | ended | error
call_type	phone_call | web_call
direction	inbound | outbound
user_sentiment	Positive | Neutral | Negative | Unknown

Filtros numéricos y de rango (NumberFilter / RangeFilter)

Aplican a: start_timestamp, end_timestamp, duration_ms, combined_cost, e2e_latency_p50

Operador	Descripción
eq	Igual a
ne	Distinto de
gt	Mayor que
ge	Mayor o igual que
lt	Menor que
le	Menor o igual que
bt	Entre dos valores (rango)

Ejemplo — llamadas iniciadas después del 1 de mayo de 2025:

"start_timestamp": { "operator": "ge", "value": 1746057600000 }

Ejemplo — llamadas de entre 60 y 300 segundos:

"duration_ms": { "operator": "bt", "low_threshold": 60000, "high_threshold": 300000 }

Filtro booleano (BooleanFilter)

Aplican a: in_voicemail, call_successful

"in_voicemail": { "operator": "eq", "value": false }

Filtros de variables dinámicas

"dynamic_variables": [
  { "key": "campaña", "operator": "eq", "value": "reactivacion-mayo" }
]

---

Respuesta — 200 OK

{
  "pagination_key": "cursor_opaco_para_siguiente_pagina",
  "has_more": true,
  "items": [ /* array de objetos de llamada */ ]
}

Campo	Descripción
pagination_key	Cursor para obtener la siguiente página. null si no hay más resultados.
has_more	true si hay más registros disponibles.
items	Array de objetos de llamada. Contiene todos los campos de la llamada excepto la transcripción (para optimizar rendimiento).

Para obtener la transcripción de una llamada específica, usa Obtener llamada.

---

Ejemplos de solicitud

Listar las últimas 20 llamadas

curl --request POST \
     --url https://calls.anunzi.net/v3/list-calls \
     --header 'Authorization: Bearer TU_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
  "limit": 20,
  "sort_order": "descending"
}'

Listar llamadas salientes de un agente específico

curl --request POST \
     --url https://calls.anunzi.net/v3/list-calls \
     --header 'Authorization: Bearer TU_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
  "filter_criteria": {
    "agent": [{ "agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD" }],
    "direction": { "operator": "eq", "value": "outbound" },
    "call_status": { "operator": "eq", "value": "ended" }
  },
  "limit": 100
}'

Paginación — segunda página

curl --request POST \
     --url https://calls.anunzi.net/v3/list-calls \
     --header 'Authorization: Bearer TU_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
  "limit": 50,
  "pagination_key": "cursor_opaco_de_respuesta_anterior"
}'

---

Códigos de estado

Código	Descripción
200	Listado devuelto correctamente.
400	Formato de solicitud inválido.
401	API Key ausente o inválida.
429	Límite de solicitudes alcanzado.
500	Error interno del servidor.