---
title: "Generate Report Link"
method: POST
path: "/reports"
tags: ["reports"]
---

# Generate Report Link

`POST /reports`

## Request

- Base URL: `https://app.tascan.io/api/v1`
- URL: `https://app.tascan.io/api/v1/reports`
- Auth: HTTP bearer

Mint a shareable report and get its link. Types: completion (full proof-of-work for one list: tasks, responses, subtasks, photos, GPS + place names, timing, QR pair), service (client-facing version of a list with YOUR company branding and a Client Acknowledgment button — the ack files into the list thread), project (every list in a project rolled up), evidence (compliance Evidence Pack; admin sign-in required to view). Links are stable — the same list/project returns the same link. Optionally text the link to a phone through the TaScan SMS lane.

## Request body

- object
  - `type` 'completion' | 'service' | 'project' | 'evidence', required
  - `list_id` string: Required for completion / service
  - `project_id` string: Required for project / evidence
  - `company_name` string: Service report branding (defaults to the org name)
  - `message` string: Service report: a note to the client shown under the header
  - `show_workers` boolean: Service report: show worker names (default true)
  - `show_issues` boolean: Service report: include reported issues (default false)
  - `send_to_phone` string: Text the link to this number (E.164 or 10-digit US)
  - `send_note` string: Short intro for the text, e.g. "Here is your report from Love Productions:"

## Response `200`

Success. JSON body: { data: ... } or an error object { error, message }.

## Other responses

- `4XX`: Client error (validation, auth, scope, rate limit).

---

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