Skip to main content
GET
/
runs
curl -X GET "https://nunu.ai/api/v1/runs?state=completed&page=0&page_size=10" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "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"],
      "players": [
        {
          "id": "ab12cd34ef56",
          "state": "completed",
          "result": "success",
          "player_number": 0,
          "test_name": "Player 1 Test",
          "step_count": 5,
          "completed_step_count": 5,
          "platform": {
            "type": "android",
            "device": "Samsung Galaxy S24"
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 10,
    "total_count": 47,
    "total_pages": 5
  }
}
Permission Required: project:read-runs
Retrieve a paginated list of runs for your project.

​
Query Parameters

​
state
string
default:"all"
Filter by state: running, completed, or all
​
page
integer
default:"0"
Page number (0-indexed)
​
page_size
integer
default:"20"
Results per page (1-100)

​
Response

​
data
Run[]
required
Array of run objects
​
pagination
object
required
Pagination information

​
Run Object

​
multiplayer_run_id
string
required
Unique identifier for the run (12 lowercase alphanumeric chars)
​
project_id
string
required
Project the run belongs to
​
state
string
required
Current state: initializing, running, or completed
​
result
string
Result: success, failure, error, or null if not completed
​
bug_info
object
Bug summary (for verification tests only)
​
test
object
required
Test information
​
build
object
Build used for the run
​
created_at
string
required
ISO 8601 timestamp when run was created
​
started_at
string
ISO 8601 timestamp when run started
​
completed_at
string
ISO 8601 timestamp when run completed
​
duration_ms
integer
Run duration in milliseconds
​
initiator
object
required
Who/what started the run
​
tags
string[]
Tags assigned to the run
​
players
Player[]
required
Individual player runs (for multiplayer tests)
curl -X GET "https://nunu.ai/api/v1/runs?state=completed&page=0&page_size=10" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "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"],
      "players": [
        {
          "id": "ab12cd34ef56",
          "state": "completed",
          "result": "success",
          "player_number": 0,
          "test_name": "Player 1 Test",
          "step_count": 5,
          "completed_step_count": 5,
          "platform": {
            "type": "android",
            "device": "Samsung Galaxy S24"
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 10,
    "total_count": 47,
    "total_pages": 5
  }
}

Authorizations

​
X-Api-Key
string
header
required

API key for authentication

Query Parameters

​
state
enum<string>
default:all

Filter by state

Available options:
running,
completed,
all
​
page
integer
default:0

Page number (0-indexed)

​
page_size
integer
default:20

Results per page (1-100)

Required range: 1 <= x <= 100

Response

Successful response

​
data
object[]
​
pagination
object