Saltar al contenido principal
GET
Listar conversaciones

Autorizaciones

Authorization
string
header
requerido

Envía Authorization: Bearer YOUR_API_KEY. La clave corresponde a una sola organización.

Parámetros de consulta

agentId
string<uuid>

Filtrar a un agente.

meta
string

Filtros de propiedades de metadatos de la conversación: key:op[:value], unidos por ; (hasta 8, todos deben cumplirse). key es una ruta con puntos dentro de los metadatos de la conversación (por ejemplo, campaign, model.provider). op es uno de eq, neq, contains, not_contains, gt, gte, lt, lte (reciben un value codificado como URI; los numéricos requieren un número), o is_set, is_not_set, is_true, is_false. Ejemplo: campaign:eq:spring%20sale;score:gte:3. Misma sintaxis que el filtro de Conversaciones del panel. Un filtro que no se puede interpretar devuelve 400. Las rutas anidadas se descubren e indexan automáticamente. Ejemplo: contexto.call_id:eq:1234567890 encuentra el ID exacto, incluso si está guardado como número JSON. Las búsquedas exactas selectivas (eq/neq) usan el índice tras verificar su cobertura histórica; los valores frecuentes y los demás operadores conservan su comportamiento sobre JSON.

referenceId
string

Coincidencia exacta con el referenceId de la conversación: el ID de llamada que envió tu proveedor o tu propio sistema (por ejemplo, el nombre de una sala de LiveKit). Se resuelve con un índice, así que es la forma rápida de encontrar una llamada por tu propio ID, sin importar su antigüedad. Normalmente devuelve cero o una conversación; el mismo ID puede repetirse entre agentes. Un valor vacío devuelve 400.

Required string length: 1 - 255
createdAfter
string

Solo conversaciones cuyo createdAt es igual o posterior a este instante (inclusivo). Una fecha ISO 8601 (2026-11-01, interpretada como medianoche UTC) o una fecha y hora con desfase UTC (2026-11-01T14:30:00Z, 2026-11-01T11:30:00-03:00). Precisión máxima de milisegundos. Una fecha y hora sin desfase, un año fuera de 1900–2299, o cualquier otro formato devuelve 400.

createdBefore
string

Solo conversaciones cuyo createdAt es anterior a este instante (exclusivo). Mismo formato que createdAfter, y debe ser posterior a él. Juntos permiten paginar una ventana, de la más reciente a la más antigua, en lugar de todo lo posterior.

limit
integer
predeterminado:50

Elementos por página. Predeterminado 50, máx. 200 (los valores mayores se limitan a 200). Debe ser un entero positivo; cualquier otro valor se rechaza con un 400 invalid_parameter.

Rango requerido: 1 <= x <= 200
cursor
string

Cursor de paginación opaco. Envía el nextCursor devuelto por la página anterior, sin modificar. Un cursor que esta API no emitió se rechaza con un 400 invalid_parameter. Los endpoints de listado también responden 400 unknown_query_parameter (con los nombres válidos) ante cualquier parámetro de consulta que no aceptan, así que un filtro mal escrito como agent_id nunca se ignora en silencio.

Respuesta

Página de conversaciones.

data
object[]
requerido
nextCursor
string | null
requerido