Get Results

Retrieve results for a completed test run

GET /api/platform/results/{runId}

Get Results

cURL

curl --request GET \
  --url https://api.example.com/api/platform/results/{runId}

200

{
  "runId": "<string>",
  "status": "<string>",
  "passed": true,
  "score": {},
  "failures": [
    {}
  ],
  "diff": {},
  "execution_time": 123
}

Request

GET /api/platform/results/{runId}

Path Parameters

runId · string · required

Run ID from startRun

Example Request

curl -X GET https://api.agentdiff.dev/api/platform/results/run-xyz789 \
  -H "X-API-Key: ad_live_sk_..."

Response

runId · string

Run identifier

status · string

Run status: "passed", "failed", or "running"

passed · boolean

Whether all assertions passed

score · object

Score breakdown

failures · array

List of failed assertions

diff · object

Full diff with inserts, updates, deletes

execution_time · number

Time in seconds from startRun to completion

Example Response

{
  "runId": "run-xyz789",
  "status": "passed",
  "passed": true,
  "score": {
    "passed": 2,
    "total": 2,
    "percent": 100.0
  },
  "failures": [],
  "diff": {
    "inserts": [
      {
        "__table__": "messages",
        "message_id": "1732645891.000200",
        "message_text": "Hello World!"
      }
    ],
    "updates": [],
    "deletes": []
  },
  "execution_time": 2.45
}

Use Cases

• Polling: Check if a run is complete
• Debugging: Inspect detailed diff after a failed test
• Logging: Store results for analysis

Errors

Error	Status	Description
run_not_found	404	Run doesn’t exist

SDK Usage

Python

results = client.get_results_for_run(runId=run.runId)

print(f"Status: {results.status}")
print(f"Passed: {results.passed}")
print(f"Score: {results.score['percent']}%")
print(f"Execution time: {results.execution_time}s")

if results.failures:
    print("Failures:")
    for f in results.failures:
        print(f"  - {f}")