Build with Lectern
REST API, webhooks, SSO and bulk-import for the schools and partners building on top of Lectern. Plain English - with curl.
Six places to start
Quickstart
Create an API token, make your first request, and ship a webhook handler in 10 minutes.
Authentication
Bearer tokens, API key scopes, rotation and revocation, and the Lectern-Version header.
API reference
Endpoints by resource: Learners, Staff, Classes, Assessments, Attendance, Finance.
Webhooks & events
Listen for term-report.published, fee.reconciled, attendance.recorded and more.
Data import & export
CSV/Excel templates, bulk endpoints, validation rules, and migration playbooks.
SSO & permissions
Google Workspace and Microsoft 365 SSO, role-based access, and the audit-log API.
List learners with a single request
Every Lectern resource works the same way: a versioned REST URL, a bearer token, and consistent JSON. Pagination is cursor-based, errors are predictable, idempotency is on by default.
- Versioned via the Lectern-Version header
- Bearer-token auth, scoped per integration
- Cursor pagination · idempotent writes
- Webhook signing with HMAC-SHA256
$ curl https://api.lectern.school/v1/learners \
-H "Authorization: Bearer sk_live_…" \
-H "Lectern-Version: 2026-01-01"{
"data": [
{
"id": "lrn_8aJ4F",
"name": "Sipho Dlamini",
"grade_level": "10",
"class": "10A",
"school_id": "sch_lectern_demo"
}
],
"has_more": false
}Bookmark these
Building something interesting?
We’d love to hear about it - and help where we can.