Get Learner(s)
GET
/v2/finplus/debtmanagement/learners
(/{id})
Use this endpoint to fetch a school's learners and optionally include the parent info and the accountable person's details.
By default, only learners with active accounts (current learners or accounts with an outstanding balance) will be returned. You can use the all_accounts
query parameter to include learners for all accounts (includes left learners and zero-balance accounts).
To include parent information in the response, set the include_parents
query parameter. For including the accountable person's details, set the include_accountable_person
query parameter.
Optionally it is possible to filter on a specific learner_id
, debtor_code
or accountable_person_id
.
Pagination
The response data includes a meta
object that contains pagination-specific metadata. You can use the following query parameters to control pagination:
limit: This parameter allows you to override the default limit of records returned, up to the
max_allowed_limit
specified in the response'smeta
object.cursor: If the
meta
object contains anext_cursor
field, it indicates that more records are available. To fetch the next set of records, include thecursor
parameter in your request with the value ofnext_cursor
. If thenext_cursor
field is not present, it means there are no more records to retrieve.reverse_order: This parameter can be used to reverse the order in which the data is returned, useful for fetching the latest records first.
Path Parameters
{id}
Integer
Optionally provide the Learner ID for retrieving a single record.
Request Headers
HTTP-X-USERNAME
*
String
As provided by d6
HTTP-X-PASSWORD
*
String
As provided by d6
HTTP-X-SCHOOLID
*
Integer
The unique identifier of the school for which the data is being queried.
Query Parameters
debtor_code
Integer
To filter on a specific Debtor Code
accountable_person_id
Integer
To filter on a specific Accountable Person ID
parent_id
Integer
To filter on a specific Parent ID
all_accounts
Boolean
Whether to include all accounts
include_parents
Boolean
Whether to include the parent data in the response
include_accountable_person
Boolean
Whether to include the accountable person's data in the response
cursor
String
To retrieve the next group of items (if any)
limit
Integer
To override the default limit of records returned (up to the max_allowed_limit
provided in the response metadata).
reverse_order
Boolean
To reverse the order the data is returned in
Response Examples
Status: 200 OK
Code Samples
Last updated