curl "https://api.signalmd.dev/v1/agents/6f1d2c3b-4a5e-4f60-8b7a-9c0d1e2f3a4b/runs/d1e2f3a4-b5c6-4d7e-8f9a-0b1c2d3e4f5a/result" \
-H "Authorization: Bearer $SIGNAL_API_KEY"import requests
url = "https://api.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result', 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.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result",
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.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result"
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.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result")
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{
"schemaVersion": 1,
"batchId": "d1e2f3a4-b5c6-4d7e-8f9a-0b1c2d3e4f5a",
"agentId": "6f1d2c3b-4a5e-4f60-8b7a-9c0d1e2f3a4b",
"status": "complete",
"message": null,
"kind": "run",
"trigger": "ci",
"targetVersion": {
"platform": "retell",
"version": 8,
"configHash": "b41f9c0e2a7d"
},
"comparedTo": {
"batchId": "e5f6a7b8-c9d0-4e1f-9a2b-3c4d5e6f7a8b",
"version": 7
},
"epoch": {
"simulatorModel": "caller-setup-a",
"judgeModel": "review-setup-a",
"judgePromptHash": "9f2c1a7e",
"scorerVersion": "2026-09-18"
},
"summary": {
"cells": 12,
"gating": 10,
"passed": 9,
"failed": 2,
"flaky": 1,
"error": 0,
"drift": 0,
"notRun": 0,
"newlyBroken": 0,
"fixed": 2
},
"cost": {
"retellUsd": 1.84,
"signalUsd": 0.21
},
"cells": [
{
"testId": "3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
"testRevision": 2,
"source": "production",
"persona": "@source",
"tier": "text",
"lane": "integrations",
"expect": "pass",
"guard": false,
"gates": true,
"gateReason": "Calibrated.",
"result": "passed",
"attempts": [
{
"runId": "f9a0b1c2-d3e4-4f5a-8b6c-7d8e9f0a1b2c",
"attempt": 1,
"result": "passed"
}
],
"k": 1,
"n": 1,
"change": "fixed",
"reason": null,
"criteria": [
{
"criterionId": "c1",
"text": "The agent offers at least one time for a cleaning",
"met": true,
"decidedBy": {
"kind": "judge",
"model": "review-setup-a",
"answers": []
},
"evidenceTurn": 9,
"quote": "I have Tuesday at 10 or Thursday at 2."
}
],
"noFixture": [],
"retellGrader": {
"status": null,
"explanation": null
},
"findings": [],
"cost": {
"retellUsd": 0.15,
"signalUsd": 0.02
}
}
]
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}Get a run's result document
The run as one document (schemaVersion 1), the same the CLI writes and webhooks post: every cell with its attempts, verdicts and who decided them, and the change from the previous comparable run, or from compareTo.
curl "https://api.signalmd.dev/v1/agents/6f1d2c3b-4a5e-4f60-8b7a-9c0d1e2f3a4b/runs/d1e2f3a4-b5c6-4d7e-8f9a-0b1c2d3e4f5a/result" \
-H "Authorization: Bearer $SIGNAL_API_KEY"import requests
url = "https://api.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result', 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.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result",
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.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result"
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.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.signalmd.dev/v1/agents/{agentId}/runs/{runId}/result")
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{
"schemaVersion": 1,
"batchId": "d1e2f3a4-b5c6-4d7e-8f9a-0b1c2d3e4f5a",
"agentId": "6f1d2c3b-4a5e-4f60-8b7a-9c0d1e2f3a4b",
"status": "complete",
"message": null,
"kind": "run",
"trigger": "ci",
"targetVersion": {
"platform": "retell",
"version": 8,
"configHash": "b41f9c0e2a7d"
},
"comparedTo": {
"batchId": "e5f6a7b8-c9d0-4e1f-9a2b-3c4d5e6f7a8b",
"version": 7
},
"epoch": {
"simulatorModel": "caller-setup-a",
"judgeModel": "review-setup-a",
"judgePromptHash": "9f2c1a7e",
"scorerVersion": "2026-09-18"
},
"summary": {
"cells": 12,
"gating": 10,
"passed": 9,
"failed": 2,
"flaky": 1,
"error": 0,
"drift": 0,
"notRun": 0,
"newlyBroken": 0,
"fixed": 2
},
"cost": {
"retellUsd": 1.84,
"signalUsd": 0.21
},
"cells": [
{
"testId": "3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
"testRevision": 2,
"source": "production",
"persona": "@source",
"tier": "text",
"lane": "integrations",
"expect": "pass",
"guard": false,
"gates": true,
"gateReason": "Calibrated.",
"result": "passed",
"attempts": [
{
"runId": "f9a0b1c2-d3e4-4f5a-8b6c-7d8e9f0a1b2c",
"attempt": 1,
"result": "passed"
}
],
"k": 1,
"n": 1,
"change": "fixed",
"reason": null,
"criteria": [
{
"criterionId": "c1",
"text": "The agent offers at least one time for a cleaning",
"met": true,
"decidedBy": {
"kind": "judge",
"model": "review-setup-a",
"answers": []
},
"evidenceTurn": 9,
"quote": "I have Tuesday at 10 or Thursday at 2."
}
],
"noFixture": [],
"retellGrader": {
"status": null,
"explanation": null
},
"findings": [],
"cost": {
"retellUsd": 0.15,
"signalUsd": 0.02
}
}
]
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}{
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"requestId": "req_8c1f0e2b4a6d9e3f7a5c1b0d"
}
}Authorizations
An API key (sig_...), or a session token from the web app.
Path Parameters
The agent's id.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"
The run's id.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"
Query Parameters
Compare with this run instead of the previous comparable one.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"
Response
The result document.
A run as one JSON document, the same one the CLI writes and webhooks post. Its field names are fixed by schemaVersion 1 and predate v1 naming: batchId is the run's id, and attempts[].runId is an attempt's id.
1 The run's id (runId on v1). The document keeps its schemaVersion 1 names because CI and webhooks already read them.
The run's status: queued, awaiting_approval, running, complete, refused or failed.
run or calibration.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
What scored a result. Results scored in different epochs are not compared.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Retell's share is the customer's spend; SignalMD's is ours to serve. Estimates.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Present when the run played a shadow copy; the version is the one it was cloned from.
Show child attributes
Show child attributes
Was this page helpful?