curl -X GET "https://nunu.ai/api/v1/project/your-project-id/tests?page=0&page_size=25" \
-H "X-Api-Key: YOUR_API_TOKEN"
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/tests?folder_path=regression/smoke" \
-H "X-Api-Key: YOUR_API_TOKEN"
const response = await fetch(
"https://nunu.ai/api/v1/project/your-project-id/tests?folder_path=regression/smoke",
{ headers: { "X-Api-Key": process.env.NUNU_API_TOKEN } }
);
const data = await response.json();
import requests, os
response = requests.get(
"https://nunu.ai/api/v1/project/your-project-id/tests",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"folder_path": "regression/smoke"},
)
data = response.json()
{
"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
}
}
{
"error": "supply either folder_path or folder_id, not both"
}
Tests
List Tests
Retrieve a paginated list of test cases for your project, optionally filtered to a single folder.
GET
/
project
/
{projectId}
/
tests
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/tests?page=0&page_size=25" \
-H "X-Api-Key: YOUR_API_TOKEN"
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/tests?folder_path=regression/smoke" \
-H "X-Api-Key: YOUR_API_TOKEN"
const response = await fetch(
"https://nunu.ai/api/v1/project/your-project-id/tests?folder_path=regression/smoke",
{ headers: { "X-Api-Key": process.env.NUNU_API_TOKEN } }
);
const data = await response.json();
import requests, os
response = requests.get(
"https://nunu.ai/api/v1/project/your-project-id/tests",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"folder_path": "regression/smoke"},
)
data = response.json()
{
"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
}
}
{
"error": "supply either folder_path or folder_id, not both"
}
Authentication: Any authenticated API key
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
string
Folder path (e.g.
"regression/smoke"). "/" or omitting the field means root.
Mutually exclusive with folder_id — supplying both returns 400.string
Pre-resolved folder UUID. Mutually exclusive with
folder_path.integer
default:"0"
Page number (0-indexed)
integer
default:"25"
Results per page (1-100)
Response
TestSummary[]
required
Array of test summary objects
object
required
Pagination metadata (
page, page_size, total_count, total_pages)TestSummary Object
string
required
Unique identifier for the test (UUID)
string
required
Test name
string
required
Test kind:
verification, discovery, or taskstring
Folder UUID, or
null if the test is at the project rootstring
required
Resolved folder path string (e.g.
"regression/smoke"). "/" if at root.curl -X GET "https://nunu.ai/api/v1/project/your-project-id/tests?page=0&page_size=25" \
-H "X-Api-Key: YOUR_API_TOKEN"
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/tests?folder_path=regression/smoke" \
-H "X-Api-Key: YOUR_API_TOKEN"
const response = await fetch(
"https://nunu.ai/api/v1/project/your-project-id/tests?folder_path=regression/smoke",
{ headers: { "X-Api-Key": process.env.NUNU_API_TOKEN } }
);
const data = await response.json();
import requests, os
response = requests.get(
"https://nunu.ai/api/v1/project/your-project-id/tests",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"folder_path": "regression/smoke"},
)
data = response.json()
{
"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
}
}
{
"error": "supply either folder_path or folder_id, not both"
}
Authorizations
API key for authentication
Path Parameters
The project ID. You can copy it from the project settings page or the project URL in the dashboard.
Query Parameters
Folder path filter (mutually exclusive with folder_id). "/" or omitted means root.
Folder UUID filter (mutually exclusive with folder_path)
Page number (0-indexed)
Results per page (1-100)
Required range:
1 <= x <= 100