What the API is
Klasstack runs your school records: students, classes, results, fees, messaging. The API puts those records behind a stable HTTP interface at https://api.klasstack.com/v1 so you can build your own front end on top of them and keep using the Klasstack dashboard at the same time.
It is headless, not multi-school. Every key belongs to one school and can only ever reach that school data. There are no standalone developer accounts: a developer is either the school own staff or a vendor the school has invited.
How to get a key
Open the Developer section
It lives inside your school dashboard, alongside the rest of the settings. School admins have access by default, and an admin can invite an outside vendor as a Developer member who sees only this section.
Turn on multi-factor authentication
MFA is mandatory for everyone holding developer access. You will be asked to enrol before you can create an app, and again when you approve anything risky.
Create an app and take your test keys
Name the app, tick the services it needs and the read or write access for each, and your test keys are issued immediately. Build the whole integration against them at no cost.
Go live
A live key needs the school KYC approved and an admin to switch the app live, with an MFA re-check. The key is shown once, so store it in your server secret manager right away.
Open your school dashboard to find the Developer section, or read the authentication guide first.
Your first request
Paste this, swap in your test key, and you have a working call. A test key answers from the documented example, so it works before the school is live and it is never billed.
curl https://api.klasstack.com/v1/school \
-H "Authorization: Bearer ks_test_sk_your_key_here"{
"data": {
"id": 14,
"name": "Springfield Academy",
"subdomain": "springfield",
"city": "Lekki",
"state": "Lagos",
"currency": "NGN"
},
"meta": { "request_id": "req_01HZY8N2Q0K3M4P5R6S7T8U9V0", "cost": 0 }
}The guides
Authentication and keys
Every call carries an app key. This page covers the key formats, test versus live, and how to rotate or revoke a key safely.
End-user authentication
Sign parents, students and staff in to your app, then call the API as that person. There are two ways in: the hosted sign-in page, where your app never sees a password, and a direct login API for your own server.
Errors
Every refusal uses one envelope and one stable machine code. Branch on the code, never on the message or the wording.
Pagination
List endpoints page with an opaque cursor and a limit. Follow the cursor, never build one.
Idempotency
Send an Idempotency-Key on every write so a retry after a timeout cannot write twice.
Billing
Every plan includes a monthly naira API credit. Usage draws that credit first, then the school service wallet. Test calls are free.
Money-out
Withdrawals and payroll disbursement move real money, so they sit behind more checks than any other service. This page covers each check and what happens after a request is accepted.
Webhooks
Register an HTTPS endpoint and Klasstack sends it a signed POST when something happens in the school. Deliveries are retried, logged and can be replayed.
API reference
Every endpoint currently exposed, 58 of them, with parameters, an example response and the errors each one can answer.