🧾 Get Course Students

The courseStudents query retrieves a paginated roster of course enrollments for your college — one record per student and course. You can filter by course, degree, status, date ranges, and student identifiers.

Parameters

Parameter	Type	Description
`filters`	CourseStudentsFilterInput	Optional filters to narrow the results (see below).
`pagination`	Pagination	Define `skip` and `take` values to limit results (default: `skip: 0`, `take: 200`).

Input Object: CourseStudentsFilterInput

Field	Type	Description
`readyForSubmission`	Boolean	When `true`, returns only enrollments where the student has met every course requirement (workload, assignments, meetings, grade threshold) and can be submitted for evaluation.
`isActiveDegreeStudent`	Boolean	When `true`, returns only students with an active degree enrollment.
`courseIds`	[ID!]	Limit results to these courses.
`degreeIds`	[ID!]	Limit results to these degrees.
`statuses`	[CourseStudentStatus!]	Filter by enrollment status (`ACTIVE`, `SUBMITTED`, `PASSED`, `FAILED`).
`createdGTE`	String	ISO 8601. Inclusive lower bound on the enrollment's `created` date.
`createdLTE`	String	ISO 8601. Inclusive upper bound on the enrollment's `created` date.
`accomplishedGTE`	String	ISO 8601. Inclusive lower bound on `accomplished`. Always pair with `statuses: [PASSED]`: only there is `accomplished` the pass time.
`accomplishedLTE`	String	ISO 8601. Inclusive upper bound on `accomplished`; a bare date covers that whole day (UTC).
`userIds`	[ID!]	Woolf user IDs — the `studentId` a `STUDENT_PASSED_COURSE` webhook carries. Limits results to those students.
`externalIds`	[String!]	Your college's own student IDs (the external ID you set on each student). Limits results to those students.

Note: Combine readyForSubmission: true with isActiveDegreeStudent: true to list exactly the students who are ready to be submitted for evaluation — the same logic Woolf uses internally. You can then submit them with submitStudentsForEvaluation.

Response Fields

Field	Type	Description
`count`	Int!	Total number of matching enrollments.
`list`	[CourseStudent]!	List of retrieved course enrollments.
`id`	ID!	Unique identifier of the course enrollment.
`userId`	ID!	Woolf user ID of the student.
`updated`	DateTime!	Timestamp when the enrollment was last updated.
`created`	DateTime!	Timestamp when the enrollment was created.
`accomplished`	DateTime	The time the student passed the course. Only meaningful when `status` is `PASSED`: an `ACTIVE` or `SUBMITTED` enrollment can still hold the time its last submission was rejected.
`courseId`	ID!	Course the student is enrolled in.
`rejectionReason`	String	Reason the last submission for evaluation was rejected, if applicable.
`runningAverage`	Float!	Current running average grade for the course.
`finalAverage`	Float!	Final average grade for the course.
`degreeId`	ID	Degree the course enrollment counts toward, if any.
`status`	CourseStudentStatus	Enrollment status (`ACTIVE`, `SUBMITTED`, `PASSED`, `FAILED`).
`workloadRequired`	Int!	Workload required to complete the course.
`workloadCompleted`	Int!	Workload the student has completed.
`meetingRequired`	Int!	Number of meetings required.
`meetingCompleted`	Int!	Number of meetings attended.
`publicationReviewedCompleted`	Int!	Number of peer-reviewed publications completed.
`publicationReviewedRequired`	Int!	Number of peer-reviewed publications required.
`assignmentRequired`	Int!	Number of assignments required.
`assignmentCompleted`	Int!	Number of assignments completed.
`assignmentSummativeRequired`	Int!	Number of summative assignments required.
`assignmentSummativeCompleted`	Int!	Number of summative assignments completed.

🧾 Get Course Students

Parameters

Input Object: CourseStudentsFilterInput

Response Fields

🚀 Request (Try It)