Listar llamadas

Devuelve las llamadas a las que tu API Key tiene acceso, de la más reciente a la más antigua. Una clave con alcance Todos los agentes devuelve las llamadas de todos los agentes de tu empresa; una clave con alcance Agentes específicos devuelve únicamente las llamadas atendidas por los agentes vinculados a esa clave.

Endpoint

GET /v1/calls

Parámetros de consulta

Parámetro	Tipo	Por defecto	Descripción
page	integer	1	Número de página a obtener (empezando en 1). Valores menores a 1 se ajustan a 1.
limit	integer	20	Cantidad de llamadas por página. Máximo 100.
agent	string	—	Opcional. Devuelve solo las llamadas atendidas por el agente con este slug. Devuelve 404 si el slug no existe o esta clave no tiene acceso.
startDate	string	—	Opcional. Devuelve solo las llamadas creadas en esta fecha o después (ISO 8601, p. ej. 2026-08-01). Debe enviarse junto con endDate.
endDate	string	—	Opcional. Devuelve solo las llamadas creadas en esta fecha o antes (ISO 8601). Debe enviarse junto con startDate.

Ejemplo de solicitud

curl -X GET "https://api.fonema.ai/v1/calls?page=1&limit=20&agent=agente-de-ventas-ab12cd34" \
  -H "Authorization: Bearer TU_API_KEY_AQUI"

Respuesta

{
  "offset": 0,
  "total": 128,
  "limit": 20,
  "currentPage": 1,
  "totalPages": 7,
  "calls": [
    {
      "uid": "aBcDeFgHiJkL",
      "agent": { "name": "Agente de Ventas", "slug": "agente-de-ventas-ab12cd34" },
      "toNumber": "+525599999999",
      "endedReason": "customer-ended-call",
      "createdAt": "2026-08-06T17:00:00.000Z",
      "startAt": "2026-08-06T17:00:05.000Z",
      "endAt": "2026-08-06T17:02:35.000Z",
      "durationSeconds": 150,
      "successEvaluation": true,
      "inputData": {
        "name": "Juan Pérez",
        "montoDeuda": "30000"
      }
    }
  ]
}

Campos de la respuesta

Campo	Tipo	Descripción
total	integer	Número total de llamadas que coinciden con la consulta.
limit	integer	Tamaño de página usado en esta respuesta.
offset	integer	Cantidad de llamadas omitidas antes de esta página.
currentPage	integer	Página devuelta.
totalPages	integer	Número total de páginas disponibles.
calls	array	Lista de llamadas, de la más reciente a la más antigua.
calls[].uid	string	Identificador único de la llamada. Úsalo en Consultar llamada.
calls[].agent	object	El agente que atendió la llamada (name y slug).
calls[].toNumber	string	Número telefónico al que se llamó, en formato E.164.
calls[].endedReason	string	Motivo por el que terminó la llamada (p. ej. customer-ended-call, voicemail).
calls[].createdAt	string	Cuándo se creó la llamada (se encoló).
calls[].startAt	string | null	Cuándo se contestó la llamada. null si nunca se conectó.
calls[].endAt	string | null	Cuándo terminó la llamada.
calls[].durationSeconds	integer	Duración de la llamada en segundos. 0 si nunca se conectó.
calls[].successEvaluation	boolean	Si la llamada cumplió los criterios de éxito del agente.
calls[].inputData	object	Las variables enviadas al crear la llamada (p. ej. vía Iniciar una llamada).

tip

Usa el uid que se devuelve aquí como identificador en las solicitudes de Consultar llamada.

Errores

Estado	Descripción
404	El slug de agent no existe o esta API Key no tiene acceso a él.