Skip to main content
GET
/
jobs
curl -X GET "https://nunu.ai/api/v1/jobs?status=running&tags=nightly,regression&page=0&page_size=10" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "job_id": "f80f6230-3a4f-431a-9d55-d11b867fed4e",
      "project_id": "test",
      "status": "COMPLETED",
      "created_at": "2026-03-03T15:50:19.544603+00:00",
      "completed_at": "2026-03-03T15:54:24.463635+00:00",
      "multiplayer_test_id": "a5060a07-d386-4279-98ce-b33fb884201e",
      "test_name": "ftue",
      "platform": "lt_phone",
      "build_id": null,
      "test_plan_execution_id": null,
      "queue_rejection_reason": null,
      "templating_enabled": true,
      "stopped_by": null,
      "tags": ["ftue"],
      "retries": {
        "total": 0,
        "remaining": 0
      },
      "runs": [
        {
          "multiplayer_run_id": "lkkg6t5612m",
          "state": "COMPLETED",
          "result": "SUCCESS",
          "started_at": "2026-03-03T15:50:23.601048+00:00",
          "completed_at": "2026-03-03T15:54:24.261038+00:00",
          "players": 1
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 10,
    "total_count": 1,
    "total_pages": 1
  }
}

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.

Permission Required: project:read-runs
Retrieve a paginated list of jobs for your project.

​
Query Parameters

​
status
string
default:"all"
Filter by status: queued, running, completed, or all
​
test_plan_execution_id
string
Filter by test plan execution ID
​
multiplayer_test_id
string
Filter by test ID
​
tags
string
Filter by tags (comma-separated). All specified tags must match. Example: tags=release,candidate
​
page
integer
default:"0"
Page number (0-indexed)
​
page_size
integer
default:"20"
Results per page (1-100)

​
Response

​
data
Job[]
required
Array of job objects
​
pagination
object
required
Pagination information

​
Job Object

​
job_id
string
required
Unique identifier for the job
​
project_id
string
required
Project the job belongs to
​
status
string
required
Job status: QUEUED, STARTING, RUNNING, STOPPING, CLEANING_UP, or COMPLETED
​
created_at
string
required
ISO 8601 timestamp when the job was created
​
completed_at
string
ISO 8601 timestamp when the job completed
​
multiplayer_test_id
string
required
Test ID associated with this job
​
test_name
string
Test name, if available
​
platform
string
Target platform, if available
​
build_id
string
Build ID used for this job
​
test_plan_execution_id
string
Test plan execution ID, if job was started from a test plan
​
queue_rejection_reason
string
Queue rejection reason, if the job was rejected
​
templating_enabled
boolean
required
Whether test templating was enabled
​
template_data
object
Template variables used for this job
​
stopped_by
object
Who stopped this job, if it was stopped
​
tags
string[]
required
Tags associated with this job
​
retries
object
required
Retry counters for this job
​
runs
RunSummary[]
required
Multiplayer runs associated with this job
curl -X GET "https://nunu.ai/api/v1/jobs?status=running&tags=nightly,regression&page=0&page_size=10" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "job_id": "f80f6230-3a4f-431a-9d55-d11b867fed4e",
      "project_id": "test",
      "status": "COMPLETED",
      "created_at": "2026-03-03T15:50:19.544603+00:00",
      "completed_at": "2026-03-03T15:54:24.463635+00:00",
      "multiplayer_test_id": "a5060a07-d386-4279-98ce-b33fb884201e",
      "test_name": "ftue",
      "platform": "lt_phone",
      "build_id": null,
      "test_plan_execution_id": null,
      "queue_rejection_reason": null,
      "templating_enabled": true,
      "stopped_by": null,
      "tags": ["ftue"],
      "retries": {
        "total": 0,
        "remaining": 0
      },
      "runs": [
        {
          "multiplayer_run_id": "lkkg6t5612m",
          "state": "COMPLETED",
          "result": "SUCCESS",
          "started_at": "2026-03-03T15:50:23.601048+00:00",
          "completed_at": "2026-03-03T15:54:24.261038+00:00",
          "players": 1
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 10,
    "total_count": 1,
    "total_pages": 1
  }
}

Authorizations

​
X-Api-Key
string
header
required

API key for authentication

Query Parameters

​
status
enum<string>
default:all

Filter by job status

Available options:
queued,
running,
completed,
all
​
test_plan_execution_id
string<uuid>

Filter by test plan execution ID

​
multiplayer_test_id
string<uuid>

Filter by test ID

​
tags
string

Filter by tags (comma-separated). All specified tags must match.

​
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