---
title: "List course enrollments"
method: GET
path: "/api/course-enrollments"
tags: ["courses"]
---

# List course enrollments

`GET /api/course-enrollments`

Admin-only. Enrollments recorded from Stripe course checkouts, newest first. Filter by course, payment status, or a search on email, name and tax code.

## Query parameters

- `course_id` string, uuid, nullable — Restrict to one course
- `payment_status` string, nullable — PaymentStatus value: pending, processing, succeeded, failed, refunded
- `search` string, nullable — Email, name or tax code
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- CourseEnrollmentListResponse — Paginated enrollment list response model.
  - `items` CourseEnrollmentListItem[], required
    - `id` string, uuid, required
    - `course_id` string, uuid, required
    - `course_slug` string, required
    - `user_id` string, uuid, nullable — Set when the checkout email matched an account
    - `email` string, required
    - `full_name` string, nullable
    - `tax_code` string, nullable
    - `vat_number` string, nullable
    - `profession` string, nullable — Not collected at checkout yet
    - `amount_total` string, nullable
    - `currency` string, nullable
    - `status` string, required — PaymentStatus value
    - `purchased_at` string, date-time, required
    - `confirmed_at` string, date-time, nullable
    - `refunded_at` string, date-time, nullable
    - `stripe_checkout_session_id` string, required
    - `stripe_payment_link_id` string, nullable — The payment link the sale came from
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)