curl --request GET \
--url https://api.zelto.ai/v1/conversations \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.zelto.ai/v1/conversations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.zelto.ai/v1/conversations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zelto.ai/v1/conversations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.zelto.ai/v1/conversations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.zelto.ai/v1/conversations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zelto.ai/v1/conversations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"source": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"receiverId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"referenceId": "<string>",
"endedReason": "<string>",
"cost": "<string>",
"startedAt": "2023-11-07T05:31:56Z",
"durationSeconds": 123,
"analysisStatus": "analyzed"
}
],
"nextCursor": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>",
"hint": "<string>",
"parameter": "<string>",
"unknown": [
"<string>"
],
"valid": [
"<string>"
],
"details": {},
"feedback": {
"endpoint": "<string>",
"method": "POST",
"message": "<string>"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>",
"hint": "<string>",
"parameter": "<string>",
"unknown": [
"<string>"
],
"valid": [
"<string>"
],
"details": {},
"feedback": {
"endpoint": "<string>",
"method": "POST",
"message": "<string>"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}Listar conversaciones
curl --request GET \
--url https://api.zelto.ai/v1/conversations \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.zelto.ai/v1/conversations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.zelto.ai/v1/conversations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zelto.ai/v1/conversations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.zelto.ai/v1/conversations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.zelto.ai/v1/conversations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zelto.ai/v1/conversations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"source": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"receiverId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"referenceId": "<string>",
"endedReason": "<string>",
"cost": "<string>",
"startedAt": "2023-11-07T05:31:56Z",
"durationSeconds": 123,
"analysisStatus": "analyzed"
}
],
"nextCursor": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>",
"hint": "<string>",
"parameter": "<string>",
"unknown": [
"<string>"
],
"valid": [
"<string>"
],
"details": {},
"feedback": {
"endpoint": "<string>",
"method": "POST",
"message": "<string>"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>",
"hint": "<string>",
"parameter": "<string>",
"unknown": [
"<string>"
],
"valid": [
"<string>"
],
"details": {},
"feedback": {
"endpoint": "<string>",
"method": "POST",
"message": "<string>"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}Autorizaciones
Parámetros de consulta
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.
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.
1 - 255Solo 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.
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.

