---
title: "Get report browser URL"
method: GET
path: "/api/v1/user/projects/{projectId}/reports/{testRunId}/browser-url"
tags: ["Reports"]
---

# Get report browser URL

`GET /api/v1/user/projects/{projectId}/reports/{testRunId}/browser-url`

## Request

- Base URL: `https://app.gaffer.sh`
- URL: `https://app.gaffer.sh/api/v1/user/projects/{projectId}/reports/{testRunId}/browser-url`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-API-Key`
  - HTTP bearer

Returns a browser-navigable URL with a signed token for viewing HTML test reports.
The token is short-lived (30 minutes) and grants read-only access to the report.
Useful for AI agents providing clickable links to Playwright, Vitest, or other HTML reports.

## Path parameters

- `projectId` string, required
- `testRunId` string, required

## Query parameters

- `filename` string

## Response `200`

Signed browser URL for report viewing

- BrowserUrlResponse: Signed URL for viewing an HTML test report in the browser.
  - `url` string, uri, required: Browser-navigable URL with signed token
  - `filename` string, required: The report filename being linked to
  - `testRunId` string, required
  - `expiresAt` string, date-time, required: When the signed URL expires
  - `expiresInSeconds` integer, required: Seconds until the URL expires

## Other responses

- `401`: Missing or invalid API key
- `404`: Resource not found

---

[API](https://skmtc.dev/gaffer/apis/gaffer-api.md) · [All operations](https://skmtc.dev/gaffer/apis/gaffer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gaffer/apis/gaffer-api/revisions/d742ab303118?raw)