---
title: "Generate a report"
method: POST
path: "/reports"
tags: ["Reports"]
---

# Generate a report

`POST /reports`

## Request

- Base URL: `https://api.surense.com/api/v1`
- URL: `https://api.surense.com/api/v1/reports`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.surense.com/oauth/token`

Generate a new report. Responds with the ID of the created report record.

## Request body

- GenerateReportRequest: Request to generate a report
  - `providerId` string, required: Provider ID
  - `params` object: Report parameters

## Response `200`

OK

- GenerateReportRecordResponse
  - `id` string, uuid

---

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