---
title: "Download the help desk analytics as CSV"
method: GET
path: "/products/help-desk/analytics/export.csv"
tags: ["help-desk"]
---

# Download the help desk analytics as CSV

`GET /products/help-desk/analytics/export.csv`

## Request

- Base URL: `https://api.sparkvault.com/v1`
- URL: `https://api.sparkvault.com/v1/products/help-desk/analytics/export.csv`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sparkvault/apis/sparkvault-api/docs/products/help-desk/analytics/export.csv/get.ts> (a function with typed inputs; its response is checked against the schema)

The same report as GET /products/help-desk/analytics, as one RFC 4180 table `section,subject,metric,value`, one record per figure. A cell a spreadsheet would run as a formula is written as text. The operator breakdown is written for org admins alone. Any member, from their own session.

## Query parameters

- `from` string, required
- `to` string, required
- `team_id` string
- `operator_id` string

## Response `200`

The report, as an attachment.

## Other responses

- `400`: VALIDATION_ERROR — a day is missing or not a calendar day, `from` is after `to`, the range passes 366 days, or `team_id` or `operator_id` is malformed.
- `401`: AUTHENTICATION_ERROR — missing or invalid credentials.
- `403`: FORBIDDEN — the credential is an API key or an impersonated session: the help desk is worked from a member's own session. HELP_DESK_SUBSCRIPTION_REQUIRED — a change that needs the help desk, on an organization that does not hold it.

## Changes

- **2026-10-28** `a9a10e328ba5`: 12 info
  - the response property `error/details` became required for the status `400`
  - the response property `error/details` became required for the status `401`
  - the response property `error/details` became required for the status `403`
  - the response property `meta` became required for the status `400`
  - …8 more
- **2026-10-28** `56d7c265a77a`: 3 breaking
  - the response property `error/details` became nullable for the status `400`
  - the response property `error/details` became nullable for the status `401`
  - the response property `error/details` became nullable for the status `403`
- **2026-10-23** `ad4c62db5e08`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sparkvault/apis/sparkvault-api/changes/products/help-desk/analytics/export.csv/get.md)

---

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