Use this endpoint to fetch one or more learner records for the specified school. By default, all current enrolled learners will be returned.
It is possible to retrieve non-current learners by providing the optional status query parameter.
When retrieving left learners, an additional optional since query parameter will allow you to specify a date, and only learners who have left after this date will be returned. By default, learners who have left in the last month will be returned. The since value may not be more than 1 year in the past.
It is possible to retrieve a single learner by providing the optional learner_id query parameter.
It is possible to retrieve the learners for a specific grade or grades, by providing the optional grade_id query parameter. This can be a single grade ID or a comma-separated list of grade ID's. The list of available grade ID's for a school can be obtained by making use of the Grade(s) Lookup endpoint.
If your subscription includes the Parent API, it is possible to include the parent/guardian data directly in the learner response payload by providing the optional include_parents query parameter. The parent/guardian data will be included in a sub-array per learner, with parent/guardian 1 followed by parent/guardian 2.
Path Parameters
Name
Type
Description
school_login_id*
Integer
The login ID of the school to retrieve data from
Query Parameters
Name
Type
Description
status
String
The status of the learners to return. Acceptable values are:
* current (default)
* left
* waitlist
since
String
The date to which left learners should be limited, when using the status parameter. Format: YYYY-MM-DD
learner_id
Integer
The ID of a specific learner
grade_id
Integer
A comma-separated list of grade ID's to filter by
include_parents
String
Whether to include the parent data in the response