Skip to main content
GET
/
runs
/
{runId}
curl -X GET "https://nunu.ai/api/v1/runs/lkkg6t5612m" \
  -H "X-Api-Key: YOUR_API_TOKEN"
{
  "multiplayer_run_id": "lkkg6t5612m",
  "job_id": "f80f6230-3a4f-431a-9d55-d11b867fed4e",
  "project_id": "test",
  "state": "COMPLETED",
  "result": "SUCCESS",
  "bug_info": null,
  "test": {
    "id": "a5060a07-d386-4279-98ce-b33fb884201e",
    "name": "create design doc",
    "type": "task"
  },
  "build": null,
  "created_at": "2026-03-03T15:50:23.601012+00:00",
  "started_at": "2026-03-03T15:50:23.601048+00:00",
  "completed_at": "2026-03-03T15:54:24.261038+00:00",
  "duration_ms": 240659.99,
  "initiator": {
    "type": "api",
    "value": { "key_id": "7f028653-0e85-4c37-87be-c59976796155" }
  },
  "tags": ["gdd"],
  "templating_enabled": true,
  "template_data": {
    "country": "Switzerland"
  },
  "players": [
    {
      "id": "lkkg6t5612m-1",
      "state": "COMPLETED",
      "result": "SUCCESS",
      "player_number": 1,
      "test_name": "create design doc",
      "composite_test_id": "58207dda-e2ca-44bd-a4e2-82b81b3ea8fa",
      "step_count": 1,
      "completed_step_count": 1,
      "platform": {
        "kind": "android-native",
        "config": {
          "device": {
            "name": "Pixel 8",
            "os_version": "14"
          }
        }
      },
      "artifacts": [
        {
          "filename": "recording.mp4",
          "url": "https://bouncer.nunu.ai/artifacts/...",
          "size": 15728640,
          "uploaded_at": "2026-03-03T15:55:00.000000+00:00"
        },
        {
          "filename": "logs.txt",
          "url": "https://bouncer.nunu.ai/artifacts/...",
          "size": 45678,
          "uploaded_at": "2026-03-03T15:55:00.000000+00:00"
        }
      ],
      "steps": [
        {
          "step_number": 1,
          "start_time": "2026-03-03T15:50:23.601048+00:00",
          "end_time": "2026-03-03T15:54:24.261038+00:00",
          "duration_ms": 240659,
          "run_state": "COMPLETED",
          "run_result": "SUCCESS",
          "report": "Successfully created a GDD for...",
          "test": {
            "test_step_id": "step-1",
            "goal": "Create a design document for",
            "finish_condition": "",
            "test_type": "task"
          }
        }
      ]
    }
  ]
}
Permission Required: project:read-runs
Retrieve detailed information about a specific run, including step-by-step results and artifacts.
curl -X GET "https://nunu.ai/api/v1/runs/lkkg6t5612m" \
  -H "X-Api-Key: YOUR_API_TOKEN"
{
  "multiplayer_run_id": "lkkg6t5612m",
  "job_id": "f80f6230-3a4f-431a-9d55-d11b867fed4e",
  "project_id": "test",
  "state": "COMPLETED",
  "result": "SUCCESS",
  "bug_info": null,
  "test": {
    "id": "a5060a07-d386-4279-98ce-b33fb884201e",
    "name": "create design doc",
    "type": "task"
  },
  "build": null,
  "created_at": "2026-03-03T15:50:23.601012+00:00",
  "started_at": "2026-03-03T15:50:23.601048+00:00",
  "completed_at": "2026-03-03T15:54:24.261038+00:00",
  "duration_ms": 240659.99,
  "initiator": {
    "type": "api",
    "value": { "key_id": "7f028653-0e85-4c37-87be-c59976796155" }
  },
  "tags": ["gdd"],
  "templating_enabled": true,
  "template_data": {
    "country": "Switzerland"
  },
  "players": [
    {
      "id": "lkkg6t5612m-1",
      "state": "COMPLETED",
      "result": "SUCCESS",
      "player_number": 1,
      "test_name": "create design doc",
      "composite_test_id": "58207dda-e2ca-44bd-a4e2-82b81b3ea8fa",
      "step_count": 1,
      "completed_step_count": 1,
      "platform": {
        "kind": "android-native",
        "config": {
          "device": {
            "name": "Pixel 8",
            "os_version": "14"
          }
        }
      },
      "artifacts": [
        {
          "filename": "recording.mp4",
          "url": "https://bouncer.nunu.ai/artifacts/...",
          "size": 15728640,
          "uploaded_at": "2026-03-03T15:55:00.000000+00:00"
        },
        {
          "filename": "logs.txt",
          "url": "https://bouncer.nunu.ai/artifacts/...",
          "size": 45678,
          "uploaded_at": "2026-03-03T15:55:00.000000+00:00"
        }
      ],
      "steps": [
        {
          "step_number": 1,
          "start_time": "2026-03-03T15:50:23.601048+00:00",
          "end_time": "2026-03-03T15:54:24.261038+00:00",
          "duration_ms": 240659,
          "run_state": "COMPLETED",
          "run_result": "SUCCESS",
          "report": "Successfully created a GDD for...",
          "test": {
            "test_step_id": "step-1",
            "goal": "Create a design document for",
            "finish_condition": "",
            "test_type": "task"
          }
        }
      ]
    }
  ]
}

Authorizations

X-Api-Key
string
header
required

API key for authentication

Path Parameters

runId
string
required

The multiplayer run ID (12 lowercase alphanumeric characters)

Pattern: ^[a-z0-9]{12}$

Response

Successful response

job_id
string

Job identifier that created this run

multiplayer_run_id
string

Unique identifier for the run (12 lowercase alphanumeric chars)

project_id
string

Project the run belongs to

state
enum<string>

Current state of the run

Available options:
initializing,
running,
completed
result
enum<string> | null

Result of the run (null if not completed)

Available options:
success,
failure,
error
bug_info
object
test
object
build
object
created_at
string<date-time>
started_at
string<date-time> | null
completed_at
string<date-time> | null
duration_ms
integer | null
initiator
object
tags
string[]
players
object[]
templating_enabled
boolean
template_data
object