Who is on this EduPage login: the account type (parent or student), every school it reaches (subdomain, school year, email) and every student with their class and school. Call this first to learn the names to pass as student to the other tools.

One-call overview for every student (or just student): today's lessons with changes and cancellations, homework and exams due in the next days_ahead days (default 3), messages and notices from the last two days, grades from the last week, and today's canteen menu. Sections that fail are listed under warnings instead of failing the whole call.

A student's lessons for date (default today) and the following days days (1-31, default 1), grouped by day. Each lesson has its period, start and end time, subject, teachers, classroom and group. Substitutions show the original lesson with cancelled: true next to its replacement with changed: true. homework_ids link a lesson to entries from get_homework. Weekends and holidays have no entries.

Homework and announced exams (tests, quizzes, oral exams) due between start_date (default today) and end_date (default two weeks later), sorted by due date. kind filters to 'homework' or 'exam' (default 'all'). Items marked done in EduPage are left out unless include_done is true. Each item has the subject, teacher, title, details, due date and any attachments.

Messages from teachers and the school (and chats) since since (default 14 days ago), newest first, with replies nested under the message they answer. Each has the author, who it was addressed to (a class, parents of a class, the whole school, or you), the full text, attachments, and confirmation_requested when the sender asked for a read receipt. search filters by text, author or recipient (accent-insensitive).

Everything on the student's EduPage timeline since since (default 7 days ago), newest first: messages, homework, grades, events, absences, payments, sign-up forms, substitutions and more. Filter with types, using the returned type or type_code values, e.g. ['grade', 'payments_published', 'enrollment']. EduPage's own tips and bookkeeping entries are hidden unless include_system is true. search matches text, author or recipient.

A student's marks for the current term, newest first, with a per-subject summary (count and weighted average). Marks run 1 (best) to 5; points and percentage marks include max_points and percent. Filter with subject (name or abbreviation) and since. For an earlier term pass school_year (the starting year, e.g. 2025 for 2025/26) and term (1 or 2).

Absences recorded for a student since since (default the start of the school year): each absence with the affected periods and whether it is excused, plus excuse notes and reminders, with totals of days absent and days not yet excused.

School calendar events for a student between start_date (default today) and end_date (default 30 days later): exams, trips, excursions, school events, parents' evenings, holidays and days off, as announced on the timeline, with the subject, teachers and classes involved.

The school's substitution plan for date (default today): lessons cancelled, moved or taught by someone else, and which teachers are away. Pass a student to see only their class, or a school subdomain (or all_classes: true) for the whole school.

The school canteen menu for date (default today) and the following days days (1-14), per meal (breakfast, snack, lunch, ...): each menu option with its dishes, allergens and portion sizes, whether a meal is ordered and which menu, the order/cancel deadlines, and the remaining meal credit.

Facts about a school (by subdomain or a student's name): the bell schedule with each period's start and end, the school's email, each student's class with its class teachers and home classroom, and how many teachers, classes, subjects and rooms it has.

Teachers at a school (by subdomain or a student's name), optionally filtered by query (part of a name, or the abbreviation used in the timetable). Each has a recipient_id for send_message.

Send a new EduPage message from this account to one or more teachers at a school (by subdomain or a student's name). recipients are teacher names or recipient_ids from list_teachers; a name must match exactly one teacher. The message cannot be unsent: confirm the recipients and text with the user before calling.

Choose a menu for a student's canteen meal on date, or cancel it. meal is 'lunch' (default), 'breakfast', 'snack', ... as returned by get_meals; menu is one of that meal's choosable_menus (e.g. 'A', 'B') or 'cancel'. Only works before the canteen's deadline. Confirm the day and choice with the user first.

Finish an EduPage login that asked for a second factor. After the user approves the login in the EduPage app, call this with no code; if EduPage emailed a code instead, pass it as code. school is only needed if several schools are waiting.