Skip to main content
GET
/
runs
/
{runId}
curl -X GET "https://nunu.ai/api/v1/runs/1g20ccrgksb" \
  -H "X-Api-Key: YOUR_API_TOKEN"
{
  "multiplayer_run_id": "1g20ccrgksb",
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "state": "completed",
  "result": "success",
  "bug_info": {
    "bug_label": "no_bugs",
    "bug_count": 0
  },
  "test": {
    "id": "789e0123-e89b-12d3-a456-426614174000",
    "name": "Main Menu Navigation Test",
    "type": "verification"
  },
  "build": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Production v1.2.3"
  },
  "created_at": "2025-01-12T10:00:00Z",
  "started_at": "2025-01-12T10:00:30Z",
  "completed_at": "2025-01-12T10:15:45Z",
  "duration_ms": 915000,
  "initiator": {
    "type": "api",
    "value": { "key_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479" }
  },
  "tags": ["nightly", "regression"],
  "templating_enabled": true,
  "template_data": {
    "player_name": "TestPlayer"
  },
  "players": [
    {
      "id": "ab12cd34ef56",
      "state": "completed",
      "result": "success",
      "player_number": 0,
      "test_name": "Player 1 Test",
      "step_count": 2,
      "completed_step_count": 2,
      "platform": {
        "type": "android",
        "device": "Samsung Galaxy S24"
      },
      "artifacts": [
        {
          "filename": "recording.mp4",
          "url": "https://bouncer.nunu.ai/artifacts/...",
          "size": 15728640,
          "uploaded_at": "2025-01-12T10:16:00Z"
        },
        {
          "filename": "logs.txt",
          "url": "https://bouncer.nunu.ai/artifacts/...",
          "size": 45678,
          "uploaded_at": "2025-01-12T10:16:00Z"
        }
      ],
      "steps": [
        {
          "step_number": 1,
          "start_time": "2025-01-12T10:00:30Z",
          "end_time": "2025-01-12T10:05:00Z",
          "duration_ms": 270000,
          "run_state": "completed",
          "run_result": "success",
          "report": "Successfully navigated to main menu...",
          "test": {
            "test_step_id": "step-1",
            "goal": "Navigate to main menu",
            "finish_condition": "Main menu is visible",
            "test_type": "verification"
          }
        },
        {
          "step_number": 2,
          "start_time": "2025-01-12T10:05:00Z",
          "end_time": "2025-01-12T10:10:00Z",
          "duration_ms": 300000,
          "run_state": "completed",
          "run_result": "success",
          "report": "Settings button clicked...",
          "test": {
            "test_step_id": "step-2",
            "goal": "Open settings menu",
            "finish_condition": "Settings menu is displayed",
            "test_type": "verification"
          }
        }
      ]
    }
  ]
}
Permission Required: project:read-runs
Retrieve detailed information about a specific run, including step-by-step results and artifacts.

Path Parameters

runId
string
required
The multiplayer run ID (12 lowercase alphanumeric characters, e.g., 1g20ccrgksb)

Response

The response includes all fields from List Runs, plus additional detailed information.

Additional Fields

templating_enabled
boolean
Whether template rendering was enabled for this run
template_data
object
Template variables used for this run

Player Details

Each player in the players array includes additional fields:
players[].artifacts
Artifact[]
Files generated during the run
players[].steps
Step[]
Step-by-step execution details

Step Test Object

test.test_step_id
string
required
Unique step identifier
test.goal
string
required
What the step is trying to accomplish
test.finish_condition
string
required
Condition that marks the step as complete
test.test_type
string
required
Type of test: verification, exploration, etc.
curl -X GET "https://nunu.ai/api/v1/runs/1g20ccrgksb" \
  -H "X-Api-Key: YOUR_API_TOKEN"
{
  "multiplayer_run_id": "1g20ccrgksb",
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "state": "completed",
  "result": "success",
  "bug_info": {
    "bug_label": "no_bugs",
    "bug_count": 0
  },
  "test": {
    "id": "789e0123-e89b-12d3-a456-426614174000",
    "name": "Main Menu Navigation Test",
    "type": "verification"
  },
  "build": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Production v1.2.3"
  },
  "created_at": "2025-01-12T10:00:00Z",
  "started_at": "2025-01-12T10:00:30Z",
  "completed_at": "2025-01-12T10:15:45Z",
  "duration_ms": 915000,
  "initiator": {
    "type": "api",
    "value": { "key_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479" }
  },
  "tags": ["nightly", "regression"],
  "templating_enabled": true,
  "template_data": {
    "player_name": "TestPlayer"
  },
  "players": [
    {
      "id": "ab12cd34ef56",
      "state": "completed",
      "result": "success",
      "player_number": 0,
      "test_name": "Player 1 Test",
      "step_count": 2,
      "completed_step_count": 2,
      "platform": {
        "type": "android",
        "device": "Samsung Galaxy S24"
      },
      "artifacts": [
        {
          "filename": "recording.mp4",
          "url": "https://bouncer.nunu.ai/artifacts/...",
          "size": 15728640,
          "uploaded_at": "2025-01-12T10:16:00Z"
        },
        {
          "filename": "logs.txt",
          "url": "https://bouncer.nunu.ai/artifacts/...",
          "size": 45678,
          "uploaded_at": "2025-01-12T10:16:00Z"
        }
      ],
      "steps": [
        {
          "step_number": 1,
          "start_time": "2025-01-12T10:00:30Z",
          "end_time": "2025-01-12T10:05:00Z",
          "duration_ms": 270000,
          "run_state": "completed",
          "run_result": "success",
          "report": "Successfully navigated to main menu...",
          "test": {
            "test_step_id": "step-1",
            "goal": "Navigate to main menu",
            "finish_condition": "Main menu is visible",
            "test_type": "verification"
          }
        },
        {
          "step_number": 2,
          "start_time": "2025-01-12T10:05:00Z",
          "end_time": "2025-01-12T10:10:00Z",
          "duration_ms": 300000,
          "run_state": "completed",
          "run_result": "success",
          "report": "Settings button clicked...",
          "test": {
            "test_step_id": "step-2",
            "goal": "Open settings menu",
            "finish_condition": "Settings menu is displayed",
            "test_type": "verification"
          }
        }
      ]
    }
  ]
}

Authorizations

X-Api-Key
string
header
required

API key for authentication

Path Parameters

runId
string
required

The multiplayer run ID (12 lowercase alphanumeric characters)

Response

Successful response

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