> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getbluejay.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v2/retrieve-simulation-results/{simulation_run_id}

> List a run's results with the grade of each success-criteria bullet.

Returns the same run and page of results as [the `/v1` endpoint](https://docs.getbluejay.ai/api-reference/endpoint/retrieve-simulation-results), with each result's success criteria graded one bullet at a time. Query parameters are the same.A result passes only when every bullet passed. `tests_passed`, `eval_failed` and `success_rate` on the run count results that way, and `criteria_pass_rate` on each result is the share of its bullets that passed, from 0 to 100.## Path parameters

\<table><thead><tr><th>Name</th>
            \<th>Type</th>
            \<th>Required</th>
            \<th>Description</th></tr></thead>
        \<tbody /></table>

## Query parameters

\<table><thead><tr><th>Name</th>
            \<th>Type</th>
            \<th>Required</th>
            \<th>Description</th></tr></thead>
        \<tbody /></table>

## Headers

\<table><thead><tr><th>Name</th>
            \<th>Type</th>
            \<th>Required</th>
            \<th>Description</th></tr></thead>
        \<tbody /></table>

## Response

\<table><thead><tr><th>Name</th>
            \<th>Type</th>
            \<th>Required</th>
            \<th>Description</th></tr></thead>
        \<tbody /></table>

## Status codes| Status | Meaning |
| - | - |
| `200` | Successful Response |
| `422` | Validation Error |## Example request```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
curl --request GET \
  --url https://api.getbluejay.ai/v2/retrieve-simulation-results/{simulation_run_id} \
  --header 'X-API-Key: <api-key>'
```## Example response```json 200 theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "simulation_run": {
    "id": "<string>",
    "simulation_id": "<string>",
    "summary": "<string>",
    "status": "RUNNING",
    "total_tests": 123,
    "tests_passed": 123,
    "tests_failed": 123,
    "tests_completed": 123,
    "success_rate": 1.5,
    "created_at": "2026-01-01T00:00:00Z",
    "eval_failed": 123
  },
  "simulation_results": [
    {
      "id": 123,
      "digital_human_id": 123,
      "result": {},
      "duration": 123,
      "start_time": "2026-01-01T00:00:00Z",
      "end_time": "2026-01-01T00:00:00Z",
      "custom_metrics": {},
      "status": "<string>",
      "latency": {},
      "events": [
        {
          "title": "<string>",
          "start_offset_ms": 123,
          "description": "<string>",
          "end_offset_ms": 123,
          "tags": [
            null
          ],
          "metadata": {}
        }
      ],
      "transcript": [
        {}
      ],
      "transcript_url": "<string>",
      "audio_url": "<string>",
      "evaluations": [
        {
          "id": "<string>",
          "created_at": "2026-01-01T00:00:00Z",
          "hallucination": true,
          "hallucination_reasoning": "<string>",
          "redundancy": true,
          "redundancy_reasoning": "<string>",
          "agent_speak_percentage": 1.5,
          "avg_agent_latency": 1.5,
          "latency": {
            "avg_agent_latency": 0,
            "max_agent_latency": 0,
            "p50_agent_latency": 0,
            "p90_agent_latency": 0,
            "p95_agent_latency": 0,
            "p99_agent_latency": 0
          },
          "filler_ignored_latency": {
            "avg_filler_ignored_latency": 0,
            "p50_filler_ignored_latency": 0,
            "p90_filler_ignored_latency": 0,
            "p95_filler_ignored_latency": 0,
            "p99_filler_ignored_latency": 0
          },
          "num_turns": 123,
          "call_summary": "<string>",
          "custom_evals": [
            null
          ],
          "custom_evals_success_rate": 1.5,
          "goal_success": true,
          "goal_reasoning": "<string>",
          "success_criteria_results": [
            null
          ],
          "criteria_pass_rate": 1.5,
          "pronunciation_score": 1.5,
          "pronunciation_reasoning": "<string>",
          "sentiment_label": "<string>",
          "sentiment_score": 1.5,
          "sentiment_scores": {
            "key": null
          },
          "custom_metrics": [
            {}
          ],
          "human_edited": true,
          "human_goal_success": true,
          "human_goal_reasoning": "<string>",
          "human_hallucination": true,
          "human_hallucination_reasoning": "<string>",
          "human_redundancy": true,
          "human_redundancy_reasoning": "<string>",
          "human_pronunciation_score": 1.5,
          "human_pronunciation_reasoning": "<string>",
          "override_goal_reason_code": "<string>",
          "override_goal_notes": "<string>",
          "override_hallucination_reason_code": "<string>",
          "override_hallucination_notes": "<string>",
          "override_redundancy_reason_code": "<string>",
          "override_redundancy_notes": "<string>",
          "override_pronunciation_reason_code": "<string>",
          "override_pronunciation_notes": "<string>",
          "last_edited_by": "<string>",
          "last_edited_at": "2026-01-01T00:00:00Z",
          "predicted_age": 1.5,
          "customer_gender": "<string>",
          "gender_confidence": 1.5,
          "detected_language": "<string>",
          "language_confidence": 1.5,
          "agent_audio_clarity": 1.5,
          "user_audio_clarity": 1.5
        }
      ],
      "tool_calls": [
        {
          "name": "<string>",
          "expected": [
            {}
          ],
          "actual": [
            {}
          ]
        }
      ],
      "trace_ids": [
        "<string>"
      ],
      "metrics": [
        {
          "metric_id": "<string>",
          "name": "<string>",
          "type": "<string>",
          "value": null,
          "not_applicable": false,
          "reasoning": "<string>"
        }
      ],
      "criteria_pass_rate": 1.5,
      "criteria": [
        {
          "id": "<string>",
          "text": "<string>",
          "passed": true,
          "reasoning": "<string>"
        }
      ]
    }
  ],
  "status": "200"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.