> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.nunu.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Run Details
> Retrieve detailed information about a specific run, including step-by-step results and artifacts.
**Permission Required**: `project:read-runs`
Retrieve detailed information about a specific run, including step-by-step results and artifacts.
```bash cURL theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/runs/lkkg6t5612m" \
-H "X-Api-Key: YOUR_API_TOKEN"
```
```typescript JavaScript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
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();
```
```python Python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
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()
```
```json 200 theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
"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"
}
}
]
}
]
}
```
## OpenAPI
````yaml GET /project/{projectId}/runs/{runId}
openapi: 3.1.0
info:
title: nunu.ai API
description: >-
The nunu.ai Public API allows you to programmatically interact with your
projects, manage test runs, and upload builds.
version: 1.0.0
servers:
- url: https://nunu.ai/api/v1
security:
- apiKeyAuth: []
paths:
/project/{projectId}/runs/{runId}:
parameters:
- name: projectId
in: path
required: true
schema:
type: string
description: >-
The project ID. You can copy it from the project settings page or the
project URL in the dashboard.
get:
tags:
- Runs
summary: Get Run Details
description: >-
Retrieve detailed information about a specific run, including
step-by-step results and artifacts.
operationId: getRunDetails
parameters:
- name: runId
in: path
required: true
description: The multiplayer run ID (12 lowercase alphanumeric characters)
schema:
type: string
pattern: ^[a-z0-9]{12}$
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/RunDetails'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Run not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
RunDetails:
allOf:
- $ref: '#/components/schemas/Run'
- type: object
properties:
templating_enabled:
type: boolean
template_data:
type: object
Error:
type: object
properties:
error:
type: string
code:
type: string
details:
type: object
Run:
type: object
properties:
job_id:
type: string
description: Job identifier that created this run
multiplayer_run_id:
type: string
description: Unique identifier for the run (12 lowercase alphanumeric chars)
project_id:
type: string
description: Project the run belongs to
state:
type: string
enum:
- initializing
- running
- completed
description: Current state of the run
result:
type: string
enum:
- success
- failure
- error
nullable: true
description: Result of the run (null if not completed)
bug_info:
type: object
nullable: true
properties:
bug_label:
type: string
bug_count:
type: integer
test:
type: object
properties:
id:
type: string
name:
type: string
type:
type: string
build:
type: object
nullable: true
properties:
id:
type: string
name:
type: string
created_at:
type: string
format: date-time
started_at:
type: string
format: date-time
nullable: true
completed_at:
type: string
format: date-time
nullable: true
duration_ms:
type: integer
nullable: true
initiator:
type: object
properties:
type:
type: string
value:
type: object
tags:
type: array
items:
type: string
players:
type: array
items:
$ref: '#/components/schemas/Player'
Player:
type: object
properties:
id:
type: string
state:
type: string
result:
type: string
player_number:
type: integer
test_name:
type: string
composite_test_id:
type: string
step_count:
type: integer
completed_step_count:
type: integer
platform:
type: object
properties:
type:
type: string
device:
type: string
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-Api-Key
description: API key for authentication
````