Get a student's fee account
Returns what one student owes, has paid and still has to pay.
GEThttps://api.klasstack.com/v1/students/{studentId}/fees
- fees:read
- Billable
- Test key: example response
Authorizations
AuthorizationstringheaderrequiredYour secret key as a bearer token, in the form Bearer ks_live_sk_... or Bearer ks_test_sk_.... Keep it on your server. A test key gets the documented example and touches no school data.
Path Parameters
studentIdstringpathrequiredExample:
305
Query Parameters
sessionIdintegerqueryExample:
3
Response
200, application/json
dataobjectrequiredShow child attributesHide child attributes
idnumberrequiredstudentIdnumberrequiredstudentCodestringrequiredstudentNamestringrequiredacademicSessionIdnumberrequiredtotalDuenumberrequiredMajor units of the school currency (naira for NGN), not kobo.
totalPaidnumberrequiredMajor units of the school currency (naira for NGN), not kobo.
totalDiscountnumberrequiredMajor units of the school currency (naira for NGN), not kobo. Waivers and discounts.
carriedForwardnumberrequiredMajor units of the school currency (naira for NGN), not kobo.
balancenumberrequiredMajor units of the school currency (naira for NGN), not kobo. Outstanding on the account.
feeItemsobject[]requiredShow child attributes of each itemHide child attributes of each item
idnumberrequiredThe fee structure id.
namestringrequiredcategorystringrequiredamountnumberrequiredMajor units of the school currency (naira for NGN), not kobo.
paidnumberrequiredMajor units of the school currency (naira for NGN), not kobo.
balancenumberrequiredMajor units of the school currency (naira for NGN), not kobo. What is still settleable on this item: the account-level waiver or discount is apportioned across the items, so the item balances never sum past the account balance.
isMandatorybooleanrequired
metaobjectrequiredShow child attributesHide child attributes
request_idstringrequiredAlso returned in the X-Request-ID header.
paginationobjectShow child attributesHide child attributes
limitintegerrequiredRequired range: x <= 100
has_morebooleanrequirednext_cursorstring or nullrequiredSend this back as
cursorfor the next page. Opaque: never parse it.
Errors
- 401invalid_api_keyNo key was presented, or the key is not valid.
- 402insufficient_balanceThe school's service wallet cannot cover this call.
- 403insufficient_scopeThe app does not hold the scope this endpoint needs.
- 404endpoint_not_exposedThis endpoint is not part of the API.
- 429rate_limitedThe rate limit was reached. Retry after the Retry-After header says.
- 503platform_unavailableThe API is not available for this school right now.
What each code means, and what to do about it, is in the errors guide.
Webhook events
This call triggers no webhook event.