> ## Documentation Index
> Fetch the complete documentation index at: https://collabase.ch/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Collabase documentation. Interface labels are quoted in English, as they appear in the product.
> Features marked Enterprise need the Collabase Enterprise Edition licence.

# Get the latest run summary

> Return the result counts of the newest test run of a test project.

Returns the name of the newest test run of a test project and how many of its results passed, failed, were blocked or skipped. When the project has no run yet, the answer is `null`.

> [!NOTE]
>
> Your API key needs the `tests:read` scope, and its user must be allowed to see test results in the space of the project.

## Path parameters

**projectId** `string` *required*

The ID of the test project. Returned by [List projects](https://collabase.ch/docs/api/test-management/list-projects.md).

## Response

Returns a summary object, or `null` when the project has no test run.

**runName** `string` *required*

Name of the newest test run.

**summary** `object` *required*

**properties**

**total** `number` *required*

All results of the run, results still waiting to be run included.

**passed** `number` *required*

Results that passed.

**failed** `number` *required*

Results that failed.

**blocked** `number` *required*

Results that were blocked.

**skipped** `number` *required*

Results that were skipped.

```bash cURL theme={"dark"}
curl -X GET "https://your-collabase.ch/api/v1/test-management/test-project/proj-abc123/latest-run-summary" \
  -H "Authorization: Bearer cb_xYz123ABCD..."
```

```json 200 theme={"dark"}
{
  "runName": "Release 2.4 regression",
  "summary": { "total": 42, "passed": 37, "failed": 3, "blocked": 1, "skipped": 1 }
}
```

```json 403 theme={"dark"}
{
  "error": { "code": "FORBIDDEN", "message": "Forbidden" }
}
```

```json 404 theme={"dark"}
{
  "error": { "code": "NOT_FOUND", "message": "Test project not found" }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.