---
title: "List the workspace's client report links, live first — never their URLs"
method: GET
path: "/api/v1/report-links"
tags: ["reports"]
---

# List the workspace's client report links, live first — never their URLs

`GET /api/v1/report-links`

## Request

- Base URL: `https://app.utmkit.co`
- URL: `https://app.utmkit.co/api/v1/report-links`
- Auth: HTTP bearer

Requires a token with the `reports:write` permission.

## Response `200`

Report links

- ReportLinkList
  - `data` ReportLink[]
    - `created_at` string, date-time
    - `host` string: The domain the report is served on
    - `id` integer
    - `revoked_at` string, date-time, nullable
    - `state` 'live' | 'revoked'

## Other responses

- `403`: Error

---

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