Enrollments

API endpoints for getting or creating enrollments

Get all enrollments

List all enrollments

GET https://your-platform-url.com/api/so2/v1/enrollments

Get all course enrollments for your instance

Headers

Name	Type	Description
Access-Control-Request-Headers*	string	authorization
Authorization*	string	Bearer <auth_token>
Content-Type*	string	application/json

200

{"username":"johndoe",
"email":"[e-mail]",
"course_id":"course-v1:MOOCit-demo-1",
"is_active":true,
"mode":"audit",
"created":"2021-03-09 20:15"
}, 
{"username":"JaneDoe",
"email":"[e-mail]",
"course_id":"course-v1:MOOCit-demo-2",
"is_active":true,
"mode":"audit",
"created":"2022-03-09 14:52"
}
...

Get enrollments by course

List enrollments by course

GET https://your-platform-url.com/api/so2/v1/enrollments?course_id={course_id}

Get course enrollments for a given course

Query Parameters

Name	Type	Description
course_id	string	the course_id course-v1:org+num+session

Headers

Name	Type	Description
Access-Control-Request-Headers*	string	authorization
Authorization*	string	Bearer <auth_token>
Content-Type*	string	application/json

200

{"username":"johndoe",
"email":"[e-mail]",
"course_id":"course-v1:MOOCit-demo-1",
"is_active":true,
"mode":"audit",
"created":"2021-03-09 20:15"
}, 
{"username":"JaneDoe",
"email":"[e-mail]",
"course_id":"course-v1:MOOCit-demo-1",
"is_active":true,
"mode":"audit",
"created":"2022-03-09 14:52"
}
...

Get enrollments by username

List enrollments by username

GET https://your-platform-url.com/api/so2/v1/enrollments?username={username}

Get course enrollments for a given username

Query Parameters

Name	Type	Description
username	string

Headers

Name	Type	Description
Access-Control-Request-Headers*	string	authorization
Authorization*	string	Bearer <auth_token>
Content-Type*	string	application/json

200

{"username": "johndoe",
"email":"[e-mail]",
"course_id":"course-v1:MOOCit-demo-1",
"is_active":true,
"mode":"audit",
"created":"2021-03-09 20:15"
}, 
{"username": "johndoe",
"email":"[e-mail]",
"course_id":"course-v1:MOOCit-demo-2",
"is_active":true,
"mode":"audit",
"created":"2022-03-09 14:52"
}
...

Get enrollments by days

List enrollments by period

GET https://your-platform-url.com/api/so2/v1/enrollments?days={days}

Get course enrollments for the last past days

Query Parameters

Name	Type	Description
days	integer

Headers

Name	Type	Description
Access-Control-Request-Headers*	string	authorization
Authorization*	string	Bearer <auth_token>
Content-Type*	string	application/json

200

{"username": "johndoe",
"email":"[e-mail]",
"course_id":"course-v1:MOOCit-demo-1",
"is_active":true,
"mode":"audit",
"created":"2021-03-09 20:15"
}, 
{"username": "johndoe",
"email":"[e-mail]",
"course_id":"course-v1:MOOCit-demo-2",
"is_active":true,
"mode":"audit",
"created":"2022-03-09 14:52"
}
...

Bulk enroll or unenroll users

Bulk enroll

POST https://your-platform-url.com/api/bulk_enroll/v1/bulk_enroll/

This endpoint allows you enroll or unenroll users to one or several courses. Permissions needed : Be a course admin for the courses you want to enroll users to.

Headers

Name	Type	Description
Access-Control-Request-Headers	string
Authorization	string	Bearer <auth_token>
Content-Type	string	application/json

Request Body

Name	Type	Description
auto_enroll*	Boolean	true
email_students*	Boolean	true or false, set if you want to send email to notify users for enrollments
action*	String	enroll or unenroll
courses*	String	course_id separated with comma
cohorts*	String	cohorts name separated with comma
identifiers*	String	user email separated with comma

200 Enrollments or unenrollments successful

{
    "action": "enroll",
    "courses": {
        "course-v1:edX+DemoX+Demo_Course": {
            "action": "enroll",
            "results": [
                {
                    "identifier": "[e-mail]",
                    "after": {
                        "enrollment": false,
                        "allowed": false,
                        "user": true,
                        "auto_enroll": true
                    },
                    "before": {
                        "enrollment": true,
                        "allowed": false,
                        "user": true,
                        "auto_enroll": true
                    }
                }
            ],
            "auto_enroll": true
        }
    },
    "email_students": true,
    "auto_enroll": true
}

404 Not found