---
title: "Generate a Tracker Report"
method: POST
path: "/public/v3/Devices/{deviceId}/generateReport"
tags: ["Devices"]
---

# Generate a Tracker Report

`POST /public/v3/Devices/{deviceId}/generateReport`

Creates a report of sensor data for the specified tracker.

## Path parameters

- `deviceId` string, required

## Headers

- `x-tive-account-id` integer, required

## Request body

- TrackerReportRequest
  - `format` string, required — The format of the report. Values include `PDF`, `PdfRawData`, or `CSV`.
  - `sensorData` string[], required — The sensor fields you would like to include in your report. At least one of the following values must be specified: `Location`, `Temperature`, `ProbeTemperature`, `Humidity`, `Pressure`, `Light`, `Motion`, `Acceleration`, `Battery`.
  - `timeZone` string, required — The timezone that report timestamps will display in.
  - `users` string[], nullable — A list of user IDs to share the report with.
  - `dateTimeStart` string, date-time, required — The UTC start date and time within the last 3 months of data to be reported on.
  - `dateTimeEnd` string, date-time — The UTC end date and time of data to be reported on. Defaults to now.

## Response `202`

Tracker report created and will be available once generated.

## Other responses

- `400` — Unable to generate the tracker report. See response message for details.
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/tive/apis/tive-public-api.md) · [All operations](https://skmtc.net/tive/apis/tive-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tive/tive-public-api/revisions/9a8d869e3cdc/schema)