curl -X GET "https://nunu.ai/api/v1/project/your-project-id/runs/lkkg6t5612m" \
-H "X-Api-Key: YOUR_API_TOKEN"
const runId = "lkkg6t5612m";
const response = await fetch(`https://nunu.ai/api/v1/project/your-project-id/runs/${runId}`, {
headers: {
"X-Api-Key": process.env.NUNU_API_TOKEN,
},
});
const data = await response.json();
import requests
import os
run_id = "lkkg6t5612m"
response = requests.get(
f"https://nunu.ai/api/v1/project/your-project-id/runs/{run_id}",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]}
)
data = response.json()
{
"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"
}
}
]
}
]
}
Runs
Get Run Details
Retrieve detailed information about a specific run, including step-by-step results and artifacts.
GET
/
project
/
{projectId}
/
runs
/
{runId}
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/runs/lkkg6t5612m" \
-H "X-Api-Key: YOUR_API_TOKEN"
const runId = "lkkg6t5612m";
const response = await fetch(`https://nunu.ai/api/v1/project/your-project-id/runs/${runId}`, {
headers: {
"X-Api-Key": process.env.NUNU_API_TOKEN,
},
});
const data = await response.json();
import requests
import os
run_id = "lkkg6t5612m"
response = requests.get(
f"https://nunu.ai/api/v1/project/your-project-id/runs/{run_id}",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]}
)
data = response.json()
{
"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-runscurl -X GET "https://nunu.ai/api/v1/project/your-project-id/runs/lkkg6t5612m" \
-H "X-Api-Key: YOUR_API_TOKEN"
const runId = "lkkg6t5612m";
const response = await fetch(`https://nunu.ai/api/v1/project/your-project-id/runs/${runId}`, {
headers: {
"X-Api-Key": process.env.NUNU_API_TOKEN,
},
});
const data = await response.json();
import requests
import os
run_id = "lkkg6t5612m"
response = requests.get(
f"https://nunu.ai/api/v1/project/your-project-id/runs/{run_id}",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]}
)
data = response.json()
{
"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
API key for authentication
Path Parameters
The multiplayer run ID (12 lowercase alphanumeric characters)
Pattern:
^[a-z0-9]{12}$The project ID. You can copy it from the project settings page or the project URL in the dashboard.
Response
Successful response
Job identifier that created this run
Unique identifier for the run (12 lowercase alphanumeric chars)
Project the run belongs to
Current state of the run
Available options:
initializing, running, completed Result of the run (null if not completed)
Available options:
success, failure, error Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
⌘I