Skip to main content
GET
/
v1
/
calls
Listar llamadas
curl --request GET \
  --url https://api-prod.studio.getsupervisor.ai/v1/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'x-workspace-id: <x-workspace-id>'
{
  "data": [
    {
      "id": "d7e0d9b2-8d8d-4cbb-a4d5-9a52c6b59d2f",
      "title": "Llamada de soporte",
      "customerPhone": "+5215555555555",
      "durationSeconds": 312,
      "supervisors": {
        "evaluations": 1,
        "discoveries": 0,
        "risks": 0
      },
      "goal": {
        "achieved": true,
        "reason": null
      },
      "startedAt": "2025-10-03T10:15:11.004Z",
      "recordingUrl": "https://example.com/recordings/d7e0d9b2.mp3",
      "agentBatchId": null,
      "agentId": "5769e110-7267-4cf7-a3ca-2d06e8fffbb3",
      "executionId": "exec_01J9Z1F9H2"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "hasPrevious": false,
    "hasNext": false,
    "sort": [
      "-startedAt",
      "id"
    ],
    "appliedFilters": []
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-workspace-id
string<uuid>
required

Identificador del workspace multi-tenant.

Query Parameters

​
page
integer
default:1

Número de página (>= 1). Por defecto es 1.

Required range: x >= 1
​
limit
integer
default:20

Tamaño de página (1..100). Por defecto 20.

Required range: 1 <= x <= 100
​
sort
string

Lista separada por comas de campos a ordenar. Usa prefijo '-' para orden descendente.

Example:

"createdAt,-id"

​
filter
string

Expresión de filtros combinados generada con el API Query Builder. Utiliza funciones como and(...), or(...), eq(...), like(...), etc. Consulta docs/api-query-builder.md para la gramática completa y ejemplos adicionales.

Expresión string compatible con el API Query Builder. Soporta composición de funciones (and, or) y operadores (eq, like, between, etc.) para filtrar resultados.

Example:

"and(eq(status,\"active\"),like(name,\"%ventas%\"))"

​
agentBatchId
string<uuid>

Filtra llamadas por identificador de batch (campaign/agent batch) asociado.

​
agentId
string<uuid>

Filtra llamadas por identificador del agente asociado.

​
executionId
string

Filtra llamadas por identificador de ejecución asociado.

​
recordedAfter
string<date-time>

Retorna llamadas con startedAt mayor o igual a la fecha indicada.

​
recordedBefore
string<date-time>

Retorna llamadas con startedAt menor o igual a la fecha indicada.

​
durationBucket
enum<string>

Filtra por duración ('short' < 60s, 'medium' 60-300s, 'long' > 300s).

Available options:
short,
medium,
long
​
goalStatus
enum<string>

Filtra por estado del objetivo ('achieved', 'not_achieved').

Available options:
achieved,
not_achieved
​
query
string

Búsqueda de texto en título y teléfono/participantes.

Response

Listado paginado de llamadas

​
data
object[]
required
​
meta
object
required