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

{
  "data": [
    {
      "id": "e1f2a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6b",
      "test_plan_id": "b3f1a2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
      "test_plan_name": "Smoke Tests",
      "build_id": "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
      "build_name": "v2.1.0-rc1",
      "status": "completed",
      "started_at": "2026-03-20T08:00:00.000000+00:00",
      "started_by": "user@example.com",
      "completed_at": "2026-03-20T08:15:30.000000+00:00",
      "total_tests": 5,
      "test_status": {
        "passed": 4,
        "failed": 1,
        "stopped": 0,
        "queued": 0,
        "running": 0
      },
      "duration_ms": 930000
    }
  ],
  "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 test plan executions for your project.

​
Query Parameters

​
test_plan_id
string
Filter by test plan ID
​
build_id
string
Filter by build ID
​
status
string
Filter by execution status: completed, in_progress, or queued
​
sort_by
string
default:"start_time"
Field to sort by: start_time, test_plan_name, or build_name
​
sort_order
string
default:"desc"
Sort direction: asc or desc
​
page
integer
default:"0"
Page number (0-indexed)
​
page_size
integer
default:"20"
Results per page (1-100)

​
Response

​
data
TestPlanExecutionSummary[]
required
Array of test plan execution summary objects
​
pagination
object
required
Pagination information

​
TestPlanExecutionSummary Object

​
id
string
required
Execution ID
​
test_plan_id
string
ID of the test plan that was executed
​
test_plan_name
string
Name of the test plan
​
build_id
string
ID of the build used
​
build_name
string
Name of the build used
​
status
string
required
Current execution status: completed, in_progress, or queued
​
started_at
string
ISO 8601 timestamp when the execution started
​
started_by
string
Who started the execution
​
completed_at
string
ISO 8601 timestamp when the execution completed
​
total_tests
integer
required
Total number of tests in this execution
​
test_status
object
required
Breakdown of test statuses
​
duration_ms
number
Total execution duration in milliseconds
curl -X GET "https://nunu.ai/api/v1/test-plan-executions?status=completed&page=0&page_size=10" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "id": "e1f2a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6b",
      "test_plan_id": "b3f1a2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
      "test_plan_name": "Smoke Tests",
      "build_id": "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
      "build_name": "v2.1.0-rc1",
      "status": "completed",
      "started_at": "2026-03-20T08:00:00.000000+00:00",
      "started_by": "user@example.com",
      "completed_at": "2026-03-20T08:15:30.000000+00:00",
      "total_tests": 5,
      "test_status": {
        "passed": 4,
        "failed": 1,
        "stopped": 0,
        "queued": 0,
        "running": 0
      },
      "duration_ms": 930000
    }
  ],
  "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

​
test_plan_id
string<uuid>

Filter by test plan ID

​
build_id
string<uuid>

Filter by build ID

​
status
enum<string>

Filter by execution status

Available options:
completed,
in_progress,
queued
​
sort_by
enum<string>
default:start_time

Field to sort by

Available options:
start_time,
test_plan_name,
build_name
​
sort_order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
​
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