curl --request GET \
--url 'https://api-prod.usefini.com/v2/test-suite/runs/public?botId=00000000-0000-4000-8000-000000000001' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch("https://api-prod.usefini.com/v2/test-suite/runs/public?botId=00000000-0000-4000-8000-000000000001", {
method: "GET",
headers: {
Authorization: "Bearer fini_your_api_key",
},
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
import requests
response = requests.request(
"GET",
"https://api-prod.usefini.com/v2/test-suite/runs/public?botId=00000000-0000-4000-8000-000000000001",
headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()
result = response.json()
[
{
"id": "00000000-0000-4000-8000-000000000015",
"criteriaGroupId": null,
"criteriaGroupName": null,
"createdAt": "2026-10-12T10:00:00.000Z",
"collections": [],
"total": 1,
"pending": 1,
"caseName": "Refund policy",
"errors": 0,
"passed": 0,
"failed": 0,
"needsRerun": false
}
]
Test Suite
List runs
List run summaries for an agent, optionally filtered by collection or group.
GET
/
v2
/
test-suite
/
runs
/
public
curl --request GET \
--url 'https://api-prod.usefini.com/v2/test-suite/runs/public?botId=00000000-0000-4000-8000-000000000001' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch("https://api-prod.usefini.com/v2/test-suite/runs/public?botId=00000000-0000-4000-8000-000000000001", {
method: "GET",
headers: {
Authorization: "Bearer fini_your_api_key",
},
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
import requests
response = requests.request(
"GET",
"https://api-prod.usefini.com/v2/test-suite/runs/public?botId=00000000-0000-4000-8000-000000000001",
headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()
result = response.json()
[
{
"id": "00000000-0000-4000-8000-000000000015",
"criteriaGroupId": null,
"criteriaGroupName": null,
"createdAt": "2026-10-12T10:00:00.000Z",
"collections": [],
"total": 1,
"pending": 1,
"caseName": "Refund policy",
"errors": 0,
"passed": 0,
"failed": 0,
"needsRerun": false
}
]
List run summaries for an agent, optionally filtered by collection or group.
pending counts queued/running cases; errors counts execution failures; failed counts completed evaluations with a fail verdict. needsRerun signals changed cases or group definitions. Search and artifact filters from the shared DTO are not applied here.
Headers
Query parameters
Response
Returns an array of run summaries, not a paginated envelope. The example intentionally has an empty array of collection origins.curl --request GET \
--url 'https://api-prod.usefini.com/v2/test-suite/runs/public?botId=00000000-0000-4000-8000-000000000001' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch("https://api-prod.usefini.com/v2/test-suite/runs/public?botId=00000000-0000-4000-8000-000000000001", {
method: "GET",
headers: {
Authorization: "Bearer fini_your_api_key",
},
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
import requests
response = requests.request(
"GET",
"https://api-prod.usefini.com/v2/test-suite/runs/public?botId=00000000-0000-4000-8000-000000000001",
headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()
result = response.json()
[
{
"id": "00000000-0000-4000-8000-000000000015",
"criteriaGroupId": null,
"criteriaGroupName": null,
"createdAt": "2026-10-12T10:00:00.000Z",
"collections": [],
"total": 1,
"pending": 1,
"caseName": "Refund policy",
"errors": 0,
"passed": 0,
"failed": 0,
"needsRerun": false
}
]
Was this page helpful?

