Enrollments

An enrollment represents a student’s registration in a course. It tracks when the student enrolled, their completion status, and their final grade. Enrollments are optional for certificate issuance but provide full academic traceability when included.

The enrollment object

{
  "uuid": "g7h8i9j0-k1l2-3456-mnop-567890123456",
  "completion_status": "completed",
  "grade": 8.75,
  "enrolled_at": "2024-02-01T00:00:00.000000Z",
  "completed_at": "2027-12-20T00:00:00.000000Z",
  "student": {
    "uuid": "f6a7b8c9-d0e1-2345-fghi-456789012345",
    "name": "Maria Fernanda Silva"
  },
  "course": {
    "uuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "name": "Bachelor of Computer Science"
  },
  "cohort": {
    "uuid": "e5f6a7b8-c9d0-1234-efgh-345678901234",
    "code": "BCS-2024-EVE"
  }
}

Field	Type	Description
`uuid`	string	Unique identifier
`completion_status`	enum	`enrolled`, `completed`, `dropped`
`grade`	decimal	Final grade (0–10, 2 decimal places), nullable
`enrolled_at`	datetime	Enrollment date
`completed_at`	datetime	Completion/graduation date, nullable
`student`	object	The enrolled student
`course`	object	The course
`cohort`	object\|null	The cohort, if applicable

List enrollments

GET /enrollments

# List all completed enrollments for a course
curl "https://api.dokstamp.com/enrollments?where[completion_status]=completed&where[course_uuid]=c3d4e5f6-a7b8-9012-cdef-123456789012" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "X-Tenant: {TENANT}"

Create an enrollment

POST /enrollments

Parameter	Type	Required	Description
`student_uuid`	string	Yes	Student UUID
`course_uuid`	string	Yes	Course UUID
`enrolled_at`	date	Yes	Enrollment date (`YYYY-MM-DD`)
`cohort_uuid`	string	No	Cohort UUID
`completion_status`	enum	No	`enrolled` (default), `completed`, `dropped`
`grade`	decimal	No	Final grade (min: 0)
`completed_at`	date	No	Completion date

curl -X POST https://api.dokstamp.com/enrollments \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Tenant: {TENANT}" \
  -d '{
    "student_uuid": "f6a7b8c9-d0e1-2345-fghi-456789012345",
    "course_uuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "cohort_uuid": "e5f6a7b8-c9d0-1234-efgh-345678901234",
    "enrolled_at": "2024-02-01",
    "completion_status": "completed",
    "grade": 8.75,
    "completed_at": "2027-12-20"
  }'

Get, update, delete

GET    /enrollments/{uuid}
PATCH  /enrollments/{uuid}
PUT    /enrollments/{uuid}
DELETE /enrollments/{uuid}
DELETE /enrollments/batch/destroy

The enrollment_uuid is an optional field on POST /certificates. Including it links the certificate to the specific enrollment record, enabling full traceability from enrollment to credential issuance.

Getting Started

Core Concepts

Authentication

Institutions

Organizations

Courses

Modules

Students

Enrollments

Certificates

Certificate Templates

Files

Guides

Integration Guide

Enrollments

Enrollments

The enrollment object

List enrollments

Create an enrollment

Get, update, delete

​Enrollments

​The enrollment object

​List enrollments

​Create an enrollment

​Get, update, delete

Enrollments

The enrollment object

List enrollments

Create an enrollment

Get, update, delete