---
title: "Export Users"
method: GET
path: "/admin/users/export"
tags: ["admin"]
---

# Export Users

`GET /admin/users/export`

Export user data as CSV or get a count and sample.
Filters by role and grade.

## Query parameters

- `role` string, nullable
- `grade` string, nullable
- `download` boolean — Set to true to download CSV

## Response `200`

A CSV file of the exported users. When download=true, this media type is returned.

- UserExportResponse
  - `count` integer, required
  - `sample` UserExportData[], required
    - `id` string, required
    - `email` string, email, required
    - `full_name` string, nullable
    - `role` string, nullable
    - `grade` string, nullable
    - `country` string, nullable
    - `created_at` string, date-time, nullable
    - `is_onboarded` boolean, nullable
    - `has_completed_grade_step` boolean, nullable
    - `stripe_customer_id` string, nullable
    - `stripe_subscription_id` string, nullable
    - `subscription_status` string, nullable
    - `trial_end` string, date-time, nullable
    - `math_confidence` integer, nullable
    - `current_results_perception` string, nullable
    - `current_results_slider_value` integer, nullable
    - `motivation_level_slider_value` integer, nullable
    - `interests_main` string[]
    - `motivation_reasons` string[]
    - `study_hours_daily_goal` number, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/c407f3b5a05b/schema)