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

{
  "data": [
    {
      "id": "a5060a07-d386-4269-98ce-b33fb894201e",
      "name": "Sanity smoke",
      "type": "verification",
      "folder_id": "f01a3b1c-9d2e-4f05-8c7a-1a2b3c4d5e6f",
      "folder_path": "regression/smoke"
    },
    {
      "id": "b1234567-89ab-cdef-0123-456789abcdef",
      "name": "Settings menu",
      "type": "verification",
      "folder_id": null,
      "folder_path": "/"
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 25,
    "total_count": 2,
    "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.

Authentication: Any authenticated API key
Retrieve a paginated list of test cases for your project, optionally filtered to a single folder. The response is intentionally lean so it can be used for scanning or building selectors — fetch Get Test for the full body of a specific test.
When neither folder_path nor folder_id is supplied, every test in the project is returned (including tests in nested folders). Specifying a folder returns only the tests directly inside that folder — recursion is not performed.

​
Query Parameters

​
folder_path
string
Folder path (e.g. "regression/smoke"). "/" or omitting the field means root. Mutually exclusive with folder_id — supplying both returns 400.
​
folder_id
string
Pre-resolved folder UUID. Mutually exclusive with folder_path.
​
page
integer
default:"0"
Page number (0-indexed)
​
page_size
integer
default:"25"
Results per page (1-100)

​
Response

​
data
TestSummary[]
required
Array of test summary objects
​
pagination
object
required
Pagination metadata (page, page_size, total_count, total_pages)

​
TestSummary Object

​
id
string
required
Unique identifier for the test (UUID)
​
name
string
required
Test name
​
type
string
required
Test kind: verification, discovery, or task
​
folder_id
string
Folder UUID, or null if the test is at the project root
​
folder_path
string
required
Resolved folder path string (e.g. "regression/smoke"). "/" if at root.
curl -X GET "https://nunu.ai/api/v1/tests?page=0&page_size=25" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "id": "a5060a07-d386-4269-98ce-b33fb894201e",
      "name": "Sanity smoke",
      "type": "verification",
      "folder_id": "f01a3b1c-9d2e-4f05-8c7a-1a2b3c4d5e6f",
      "folder_path": "regression/smoke"
    },
    {
      "id": "b1234567-89ab-cdef-0123-456789abcdef",
      "name": "Settings menu",
      "type": "verification",
      "folder_id": null,
      "folder_path": "/"
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 25,
    "total_count": 2,
    "total_pages": 1
  }
}

Authorizations

​
X-Api-Key
string
header
required

API key for authentication

Query Parameters

​
folder_path
string

Folder path filter (mutually exclusive with folder_id). "/" or omitted means root.

​
folder_id
string<uuid>

Folder UUID filter (mutually exclusive with folder_path)

​
page
integer
default:0

Page number (0-indexed)

​
page_size
integer
default:25

Results per page (1-100)

Required range: 1 <= x <= 100

Response

Successful response

​
data
object[]
​
pagination
object