Get a run

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

# Get a run

> Fetch one test set run and its detailed result.

Fetches one run with its full result when available.

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token containing your Fini workspace API key. Format: `Bearer fini_...` The key needs `read` scope.
</ParamField>

## Path parameters

<ParamField path="runId" type="string" required>
  Run ID.
</ParamField>

## Response

Returns a [Run object](/en/api-reference/test-sets#run-object). While the run is queued or processing, `result` is `null`.

<RequestExample>
  ~~~bash cURL theme={null}
  curl --request GET \
    --url 'https://api-prod.usefini.com/v2/test-sets/runs/5afd818a-a5f9-4e1b-9619-3c7191c12d9a/public' \
    --header 'Authorization: Bearer fini_your_api_key'
  ~~~

  ~~~javascript Node.js theme={null}
  const runId = '5afd818a-a5f9-4e1b-9619-3c7191c12d9a';

  const response = await fetch(`https://api-prod.usefini.com/v2/test-sets/runs/${runId}/public`, {
    method: 'GET',
    headers: {
      Authorization: 'Bearer fini_your_api_key'
    }
  });

  const run = await response.json();
  ~~~

  ~~~python Python theme={null}
  import requests

  run_id = "5afd818a-a5f9-4e1b-9619-3c7191c12d9a"

  response = requests.get(
      f"https://api-prod.usefini.com/v2/test-sets/runs/{run_id}/public",
      headers={"Authorization": "Bearer fini_your_api_key"},
  )

  run = response.json()
  ~~~
</RequestExample>

<ResponseExample>
  ~~~json 200 OK theme={null}
  {
    "id": "5afd818a-a5f9-4e1b-9619-3c7191c12d9a",
    "testSetId": "44c1f705-8e1a-4f61-8c4c-d519d37fb6b7",
    "status": "completed",
    "result": {
      "summary": {
        "testSetResult": "pass",
        "totalConversations": 2,
        "passedConversations": 2,
        "failedConversations": 0,
        "errorConversations": 0,
        "totalCriteria": 2,
        "passedCriteria": 4,
        "failedCriteria": 0
      },
      "conversations": [
        {
          "hcInteractionId": "a5221094-72d4-4b9c-8d30-2f785b108bd9",
          "replayInteractionId": "63e246cb-f2ac-4f85-8c5a-1ef750d1bb40",
          "botId": "0d5e93fa-e427-48df-a32e-74c98315ad12",
          "promptVersionId": "9bc3fb9f-85fd-496e-90b3-bcc80ff12d70",
          "promptVersionNumber": 8,
          "interactionSubject": "Customer asks about refund eligibility",
          "result": "pass",
          "error": null,
          "criteriaResults": [
            {
              "criteriaId": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
              "name": "Goal resolution",
              "type": "complex_judge",
              "blocking": true,
              "result": "pass",
              "reasoning": "The answer resolved the refund-policy question.",
              "evidence": ["The agent explained eligibility and next steps."]
            }
          ]
        }
      ],
      "environment": {
        "ruleExecutionMode": "simulate",
        "bot": {
          "botId": "0d5e93fa-e427-48df-a32e-74c98315ad12",
          "promptVersionId": "9bc3fb9f-85fd-496e-90b3-bcc80ff12d70",
          "promptVersionNumber": 8,
          "ruleVersionIds": [
            "71c4d0ac-64fc-47e0-b844-c618b10b9a2e",
            "882c6fdb-8b64-4572-8527-5143dc097f6c"
          ]
        }
      }
    },
    "createdBy": null,
    "createdAt": "2026-07-28T09:01:14.000Z",
    "updatedAt": "2026-07-28T09:02:09.000Z"
  }
  ~~~
</ResponseExample>


## Related topics

- [Start a run](/en/api-reference/start-test-set-run.md)
- [Overview](/en/api-reference/test-sets.md)
- [Get rule version test paths](/en/api-reference/get-rule-version-test-paths.md)


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