List Runs - nunu.ai

curl -X GET "https://nunu.ai/api/v1/project/your-project-id/runs?state=completed&tags=nightly&bugs=true&page=0&page_size=10" \
  -H "X-Api-Key: YOUR_API_TOKEN"

const response = await fetch(
  "https://nunu.ai/api/v1/project/your-project-id/runs?state=completed&tags=nightly&bugs=true&page=0&page_size=10",
  {
    headers: {
      "X-Api-Key": process.env.NUNU_API_TOKEN,
    },
  }
);
const data = await response.json();

import requests
import os

response = requests.get(
    "https://nunu.ai/api/v1/project/your-project-id/runs",
    headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
    params={"state": "completed", "tags": "nightly", "bugs": True, "page": 0, "page_size": 10}
)
data = response.json()

{
  "data": [
    {
      "job_id": "f80f6230-3a4f-431a-9d54-d11b867fed4e",
      "multiplayer_run_id": "lkkg6t5612m",
      "project_id": "test",
      "state": "COMPLETED",
      "result": "SUCCESS",
      "bug_info": null,
      "test": {
        "id": "a5060a07-d386-4269-98ce-b33fb894201e",
        "name": "sanity test",
        "type": "verification"
      },
      "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": ["nightly"],
      "players": [
        {
          "id": "lkkg6t5612m-1",
          "state": "COMPLETED",
          "result": "SUCCESS",
          "player_number": 1,
          "test_name": "sanity test",
          "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"
              }
            }
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 10,
    "total_count": 501,
    "total_pages": 51
  }
}

GET

project

{projectId}

runs

curl -X GET "https://nunu.ai/api/v1/project/your-project-id/runs?state=completed&tags=nightly&bugs=true&page=0&page_size=10" \
  -H "X-Api-Key: YOUR_API_TOKEN"

const response = await fetch(
  "https://nunu.ai/api/v1/project/your-project-id/runs?state=completed&tags=nightly&bugs=true&page=0&page_size=10",
  {
    headers: {
      "X-Api-Key": process.env.NUNU_API_TOKEN,
    },
  }
);
const data = await response.json();

import requests
import os

response = requests.get(
    "https://nunu.ai/api/v1/project/your-project-id/runs",
    headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
    params={"state": "completed", "tags": "nightly", "bugs": True, "page": 0, "page_size": 10}
)
data = response.json()

{
  "data": [
    {
      "job_id": "f80f6230-3a4f-431a-9d54-d11b867fed4e",
      "multiplayer_run_id": "lkkg6t5612m",
      "project_id": "test",
      "state": "COMPLETED",
      "result": "SUCCESS",
      "bug_info": null,
      "test": {
        "id": "a5060a07-d386-4269-98ce-b33fb894201e",
        "name": "sanity test",
        "type": "verification"
      },
      "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": ["nightly"],
      "players": [
        {
          "id": "lkkg6t5612m-1",
          "state": "COMPLETED",
          "result": "SUCCESS",
          "player_number": 1,
          "test_name": "sanity test",
          "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"
              }
            }
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 10,
    "total_count": 501,
    "total_pages": 51
  }
}

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

multiplayer_test_id

string

Filter by test ID

job_id

string

Filter by job ID

test_plan_execution_id

string

Filter by test plan execution ID

test_type

string

Filter by test type (e.g., verification)

Response

data

Run[]

required

Array of run objects

pagination

object

required

Pagination information

Show pagination properties

pagination.page

integer

Current page number

pagination.page_size

integer

Results per page

pagination.total_count

integer

Total number of runs

pagination.total_pages

integer

Total number of pages

Run Object

multiplayer_run_id

string

required

Unique identifier for the run (12 lowercase alphanumeric chars)

job_id

string

required

Job identifier that created this run

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)

Show bug_info properties

bug_info.bug_label

string

Bug label classification

bug_info.bug_count

integer

Number of bugs found

test

object

required

Test information

Show test properties

test.id

string

Test ID

test.name

string

Test name

test.type

string

Test type (e.g., verification)

build

object

Build used for the run

Show build properties

build.id

string

Build ID

build.name

string

Build name

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/project/your-project-id/runs?state=completed&tags=nightly&bugs=true&page=0&page_size=10" \
  -H "X-Api-Key: YOUR_API_TOKEN"

const response = await fetch(
  "https://nunu.ai/api/v1/project/your-project-id/runs?state=completed&tags=nightly&bugs=true&page=0&page_size=10",
  {
    headers: {
      "X-Api-Key": process.env.NUNU_API_TOKEN,
    },
  }
);
const data = await response.json();

import requests
import os

response = requests.get(
    "https://nunu.ai/api/v1/project/your-project-id/runs",
    headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
    params={"state": "completed", "tags": "nightly", "bugs": True, "page": 0, "page_size": 10}
)
data = response.json()

{
  "data": [
    {
      "job_id": "f80f6230-3a4f-431a-9d54-d11b867fed4e",
      "multiplayer_run_id": "lkkg6t5612m",
      "project_id": "test",
      "state": "COMPLETED",
      "result": "SUCCESS",
      "bug_info": null,
      "test": {
        "id": "a5060a07-d386-4269-98ce-b33fb894201e",
        "name": "sanity test",
        "type": "verification"
      },
      "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": ["nightly"],
      "players": [
        {
          "id": "lkkg6t5612m-1",
          "state": "COMPLETED",
          "result": "SUCCESS",
          "player_number": 1,
          "test_name": "sanity test",
          "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"
              }
            }
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 10,
    "total_count": 501,
    "total_pages": 51
  }
}

Authorizations

X-Api-Key

string

header

required

API key for authentication

Path Parameters

projectId

string

required

The project ID. You can copy it from the project settings page or the project URL in the dashboard.

Query Parameters

state

enum<string>

default:all

Filter by state

Available options:

running,

completed,

all

multiplayer_test_id

string<uuid>

Filter by test ID

job_id

string<uuid>

Filter by job ID

test_plan_execution_id

string<uuid>

Filter by test plan execution ID

test_type

string

Filter by test type (e.g., verification)

Response

Successful response

data

object[]

Show child attributes

pagination

object

Show child attributes

Authentication Start a Run

​Query Parameters

​Response

​Run Object

Authorizations

Path Parameters

Query Parameters

Response

Query Parameters

Response

Run Object