ElternPortal API Client 📚

This library provides an easy-to-use interface for interacting with the ElternPortal system, a platform for school-parent communication in Germany.

Features 🌟

• Authentication: Securely log in to the ElternPortal system
• Kid Management: Set and retrieve information about children linked to the account
• School Information: Fetch various details about the school
• Announcements: Get updates from the school's bulletin board (Schwarzes Brett)
• Calendar: Retrieve school events and schedules
• Parent Letters: Access and download parent letters (Elternbriefe)
• Lost and Found: View items in the lost and found section
• Exam Schedules: Get the dates of upcoming exams
• Substitute Plan: Check for changes of the timetable

Installation 💻

pnpm i @philippdormann/elternportal-api

Usage 🚀

Initializing the Client

import { getElternportalClient } from "@philippdormann/elternportal-api";

const client = await getElternportalClient({
  short: "schoolcode",
  username: "your_username",
  password: "your_password",
  kidId: 0, // Optional
});

Available Methods

Get Kids 👨‍👩‍👧‍👦

const kids = await client.getKids();

Get School Information 🏫

const schoolInfo = await client.getSchoolInfos();

Get Bulletin Board (Schwarzes Brett) 📌

const posts = await client.getSchwarzesBrett(includeArchived);

Get School Calendar (Termine) 📅

const events = await client.getTermine(fromDate, toDate);

Get Timetable 🕒

const timetable = await client.getStundenplan();

Get Lost and Found Items 🧦

const lostItems = await client.getFundsachen();

Get Parent Letters 📬

const letters = await client.getElternbriefe();

Download Files 📁

const bulletinFile = await client.getSchwarzesBrettFile(fileId);
const letterFile = await client.getElternbrief(letterId);

Get exam schedule 📆

const examSchedule = await client.getSchulaufgabenplan();

Get substitute plan 🔄

const substitutePlan = await client.getVertretungsplan();

Types 📝

The library includes TypeScript definitions for various data structures:

• SchoolInfo
• Termin (Calendar Event)
• Elternbrief (Parent Letter)
• SchwarzesBrettBox (Bulletin Board Item)
• ElternportalFile
• Vertretungsplan