Saltar al contenido principal
GET
Listar Llamadas

Descripción General

Devuelve una página de llamadas de un solo agente de la cuenta autenticada. El cuerpo es un objeto JSON. calls va ordenado por created_time descendente (las más recientes primero). page y total_pages son strings. agent_id es obligatorio. Una petición sin él no lista todos los agentes de la cuenta.

Autenticación

Parámetros de Query

string
requerido
UUID del agente del que quieres las llamadas. Tiene que pertenecer a la cuenta autenticada. assistant_id se acepta como el mismo campo. Si se envían los dos, tienen que coincidir.
number
predeterminado:"1"
Número de página, empezando en 1.
  • Mínimo: 1
  • Máximo: 1000
number
predeterminado:"50"
Llamadas por página.
  • Mínimo: 1
  • Máximo: 100
  • Por defecto: 50
string
Inicio de la ventana, en UTC. Formato: YYYY-MM-DD o YYYY-MM-DD HH:mm:ss. Se acepta un sufijo de zona (Z o +02:00) y se convierte a UTC.Hay que enviarlo junto con endDate.
string
Fin de la ventana, inclusive, en UTC. Mismos formatos que startDate.Un valor de solo día (2026-10-29) incluye ese día UTC entero, hasta las 23:59:59. Hay que enviarlo junto con startDate. El intervalo no puede superar 90 días.
number
predeterminado:"15"
Cuántos días hacia atrás desde ahora (UTC). Solo se usa si no se envían startDate y endDate.
  • Mínimo: 1
  • Máximo: 90
  • Por defecto: 15
Un valor inválido responde 400. No se sustituye por el valor por defecto.
string
Filtra por estado. Si se omite, la consulta sigue devolviendo solo llamadas en busy, closed, no-answer, silence-call, voicemail y failed.Un valor, una lista separada por comas, o el parámetro repetido:status=closedstatus=closed,voicemailstatus=closed&status=voicemailValores permitidos: busy, closed, no-answer, silence-call, voicemail, failed.Cualquier otro valor responde 400. No se ignora.

Respuesta

string
UUID del agente de esta página.
string
Nombre de ese agente.
string
La página pedida, empezando en "1".
string
ceil(llamadas que cumplen el filtro / limit), como string. "0" cuando el filtro no devuelve ninguna.Una página más allá del final sigue devolviendo este objeto con calls vacío.
array
Objetos de llamada de esta página.

Ejemplos de Peticiones

Primera página

Página siguiente

Se repiten los mismos filtros y se envía el número de página. Entre peticiones no se guarda nada en caché. page vuelve dentro del JSON.

Rango de fechas, estado y tamaño de página

endDate=2026-10-29 incluye ese día UTC entero.

Ejemplo de Respuesta

Respuestas de Error

object
Falta agent_id o no es un UUID, la fecha o el estado no son válidos, el rango supera 90 días, o page / limit están fuera de sus límites.
object
Token ausente o inválido.
object
El agente no existe en esta cuenta.
string

Notas

  • Las fechas son UTC. Un valor sin zona horaria no se lee como Europe/Madrid.
  • from se vacía cuando el valor guardado es el marcador phoneNumber.phoneNumber.
  • Cada petición vuelve a leer la base de datos. page=2 salta las primeras limit llamadas que cumplen el filtro.
  • El id de la cuenta no vale como agent_id. Hay que enviar el id de un agente.