---
title: "Create Report"
method: POST
path: "/report/create"
tags: ["Report"]
---

# Create Report

`POST /report/create`

Request the creation of one or more report(s).

When the report(s) have been generated, you will receive an email (one per requested report type) containing a link to download the report as a CSV file. The requested date range may be up to 12 months in duration, and `start_date` must not be more than 10 years in the past.

## Request body

- ReportCreateRequest
  - `end_date` string, required — The (inclusive) end date for the report data in `MM/DD/YYYY` format.
  - `report_type` string[], required — The type(s) of the report you are requesting. Allowed values are `user_activity` and `document_status`. User activity reports contain list of all users and their activity during the specified date range. Document status report contain a list of signature requests created in the specified time range (and their status).
  - `start_date` string, required — The (inclusive) start date for the report data in `MM/DD/YYYY` format.

## Response `200`

successful operation

- ReportCreateResponse
  - `report` ReportResponse, required — Contains information about the report request.
    - `success` string — A message indicating the requested operation's success
    - `start_date` string — The (inclusive) start date for the report data in MM/DD/YYYY format.
    - `end_date` string — The (inclusive) end date for the report data in MM/DD/YYYY format.
    - `report_type` string[] — The type(s) of the report you are requesting. Allowed values are "user_activity" and "document_status". User activity reports contain list of all users and their activity during the specified date range. Document status report contain a list of signature requests created in the specified time range (and their status).
  - `warnings` WarningResponse[] — A list of warnings.
    - `warning_msg` string, required — Warning message
    - `warning_name` string, required — Warning name

## Other responses

- `4XX` — failed_operation

---

[API](https://skmtc.net/hellosign/apis/dropbox-sign-api.md) · [All operations](https://skmtc.net/hellosign/apis/dropbox-sign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellosign/dropbox-sign-api/revisions/7535b8f1a188/schema)