Student information system Grade & timetable data REST API & OAuth

Custom Somtoday integration development

Appfront builds custom Somtoday integrations that make student, grade, timetable and attendance data from Somtoday available to your education app, parent or student portal, LMS or BI dashboard. Via the Somtoday REST API and OAuth, we synchronise the data read-only, scoped and GDPR-proof, so your application always works with up-to-date school data, without double entry.

What is a Somtoday integration?

Somtoday is the student administration and student information system (SIS) from Topicus, widely used in Dutch secondary education. Schools record grades, timetables, attendance and homework in it, and the system handles communication between school, parents and students. For schools and software vendors, Somtoday is therefore the central source of up-to-date student data.

In practice, a custom integration means reading student, grade, timetable and attendance data from Somtoday via the REST API and passing it on to your own education app, parent or student portal, LMS or BI dashboard. The integration is generally read-heavy, with data retrieved periodically or on demand, so your application always works with up-to-date school data without double entry.

Appfront builds in line with Topicus's Somtoday Connect approach and the OWASP ASVS security standard. Access to the API runs via the Somtoday partner programme. We tailor the endpoints, synchronisation frequency and error handling to your actual education processes, so the integration stays reliable, even during busy periods such as report meetings.

Up-to-date student data

Students, classes, grades, timetables and attendance straight from Somtoday, with no manual exports or outdated lists. Your app or portal always shows the situation as it stands in the source system.

Read-only synchronisation

The integration is read-heavy and only retrieves what is needed. Your application gets the right student, grade and timetable data, while Somtoday remains the leading system for input and management.

Privacy by design

Data on students, who are often minors, calls for care. Scoped OAuth access, data minimisation and the Dutch education privacy covenant are built in from the design stage, not added afterwards.

Our development process for Somtoday integrations

We work with a proven methodology that removes uncertainty early and delivers a stable integration. From an initial analysis of your education processes, data needs and access via the Somtoday partner programme through to go-live and ongoing maintenance, every step is aimed at an integration your team can understand and trust.

1
Analysis & scope

We map out which student, grade, timetable or attendance data you need from Somtoday, which application it needs to go to, which schools are taking part and how access via the Somtoday partner programme will be arranged.

2
Architecture

We design the integration architecture, choose the right OAuth flow and endpoints, and define an error-handling and caching strategy.

3
Development

Implementation with automated tests, structured logging and monitoring. You see working builds along the way.

4
Go-live & maintenance

A controlled go-live with data validation and a safety net, followed by ongoing maintenance and further development.

What a Somtoday integration delivers in practice

Every Somtoday integration is set up specifically for your educational processes, data needs and adjacent systems. Below are the features we deliver most often for schools, school groups and edtech vendors working with Somtoday data.

Student & class synchronisation

Students, classes, groups and enrolments from Somtoday automatically available in your application. Changes such as new students or class transfers are picked up, so your system never drifts out of step with the source system.

Grades & results

Retrieve grades, test results and progress from Somtoday for a parent or student portal, a custom app or an analytics tool. Results are exposed read-only, so Somtoday remains the leading system for recording grades.

Timetables & absence

Synchronise timetables, schedule changes and absence or truancy records to your portal or planning tool. Students and parents see the current timetable; mentors and student coordinators get timely insight into absences.

Parent & student portal

A custom portal or app in which students and parents can see grades, timetables, homework and absences — powered by Somtoday. With your own branding and functionality that suits your school, on top of the reliable data from the source system.

LMS & learning materials integration

Connect Somtoday to your LMS, learning materials platform or digital learning environment, so students and teachers work with the right groups and accounts. Student and class data form the basis for access to learning materials.

BI dashboards & reporting

Pass grade, progress and absence data from Somtoday on to Power BI or another BI platform for school leadership and the board. Insight into trends per class, year group or subject, with due attention to privacy and aggregated reporting.

Typical use cases in practice

A Somtoday integration looks very different from one organisation to the next. We see a number of patterns come up often, and for each of them we have a working setup with attention to the right endpoints, scoped access and the privacy of student data.

SOM

Secondary schools

Secondary schools that want to use Somtoday as the source system for their own parent or student portal, app or planning tool. Grades, timetables and absence flow through automatically, so students and parents always see the current status. See also our API integrations.

School groups

Boards and school federations with multiple secondary schools that want to bring together data from different Somtoday environments. One integration that handles the right scoped access per school, with central reporting and monitoring across the entire group.

Edtech builders

Educational software builders and edtech startups that want to connect their product to Somtoday as a data source. A reliable integration via the Somtoday Connect API, set up at scale and with the scoped access the partner programme requires.

Learning materials suppliers

Publishers and suppliers of digital learning materials that need student and class data from Somtoday to set up accounts, groups and progress automatically. Less manual work at the start of the school year, and always the right student with the right materials.

Technology we use

We build Somtoday integrations using the Somtoday REST API (Somtoday Connect by Topicus) and OAuth, combined with the backend stack that suits you. The exact choice depends on your data needs and adjacent systems, so that your own team can manage or further develop the implementation.

For institutions that also want to show Xedule timetables in their own app or learning environment, there is our page on a Xedule integration.

For learning materials suppliers who exchange student data and results according to Edustandaard, there is our page on a UWLR integration.

For suppliers who want to import students, groups and teachers from multiple student administration systems, there is our page on an EDEXML integration.

Somtoday REST API (Topicus) Somtoday Connect OAuth authentication Student & class endpoints Grade & result endpoints Timetable & absence endpoints Read-only synchronisation Node.js / Python / PHP / .NET Caching & rate limiting Power BI / BI dashboards LMS & learning resource integrations SURFconext / SSO Scoped tokens & secure vaults Monitoring & alerting GitHub Actions

Why choose Appfront for your Somtoday integration?

Appfront has extensive experience building API integrations for a wide range of organisations in the Netherlands. We always start with a thorough analysis of your existing systems and processes, because an integration must not only be technically sound but also add practical value to your educational processes.

For every integration we write clear documentation and make sure your own team, or a future supplier, can understand and manage the integration. No black box, but transparent code and clear agreements on monitoring, alerting and maintenance.

You work with a dedicated point of contact who understands both the technical and the functional side. That keeps communication lines short, prevents miscommunication and speeds up decisions when choices have to be made during the build.

Also take a look at our broader services around API integrations, middleware, custom software and web app development. If your school uses a different system, see our Magister integration too.

  • Experience with the Somtoday REST API, OAuth and read-only synchronisation
  • Specialist in integrations for education and supplementary educational software
  • Familiar with student, grade, timetable and absence data
  • Secure by default: scoped tokens, token rotation and data minimisation
  • Structured error handling and retry mechanisms
  • Extensive logging and monitoring from day one
  • Clear documentation that your team can read and maintain
  • A single point of contact, no passing you between account managers
  • Ongoing maintenance and proactive further development
  • An approach tailored to your existing IT landscape and the partner programme

Security and privacy in Somtoday integrations

A Somtoday integration processes data about students, who are often minors. That calls for extra care: data minimisation, scoped and read-only access, and compliance with the education privacy covenant (Privacyconvenant onderwijs). Appfront builds to the OWASP ASVS security standard, with OAuth tokens in secure vaults, scoped permissions and strictly separated rights per integration. We retrieve only the data that is genuinely needed for the purpose of the integration.

We document the data flows, endpoints and authorisations so that your processing register is complete and you can demonstrably comply with the GDPR. Access runs through the Somtoday partner programme, with the associated agreements and data processing agreements, so that the school, supplier and Topicus are clear about who processes which student data and why.

More about our approach to security: information security policy and CVD policy.

  • GDPR-compliant data processing and minimisation
  • The education privacy covenant as the starting point
  • Encryption in transit (TLS 1.2+) and at rest
  • Scoped, read-only and role-based access
  • Audit logs with traceable data flows
  • Automatic retry and dead-letter queues
  • Monitoring and alerting for anomalies
  • Documentation for your record of processing activities

Frequently asked questions about Somtoday integrations

Answers to the questions we are asked most often about Somtoday integrations.

A Somtoday integration is a technical integration between Somtoday, Topicus's student administration and student tracking system for secondary education, and another system, such as your education app, parent or student portal, LMS or BI dashboard. Student, grade, timetable and absence data is read and synchronised via the Somtoday REST API (Somtoday Connect). The integration is usually read-heavy: data is retrieved periodically or on request, so that your own application always works with up-to-date school data.

A Somtoday integration makes sense when your school, school group or edtech product uses Somtoday as the source system for student, grade and timetable data in secondary education. Somtoday is strong in secondary education. If your school uses Magister, a Magister integration is the more obvious choice; for primary education, systems such as ParnasSys are a better fit. Together with you, we look at which source system takes the lead and build the integration that suits it.

A simple integration — for example, retrieving student and grade data read-only for a single portal — can go live relatively quickly. More complex scenarios with multiple data sources, timetable and absence synchronisation, multiple schools under one umbrella organisation and an integration with an LMS or BI dashboard usually take more time. Access to the Somtoday Connect API goes through Topicus's partner or integration partner programme; we include that process in the planning. After an introductory conversation, we give you a realistic estimate.

We work with the Somtoday REST API (Topicus's Somtoday Connect) and OAuth authentication, combined with the backend stack that suits you — Node.js, Python, PHP or .NET. For student, grade, timetable and absence endpoints, we set up a read-only synchronisation with caching and error handling. For reporting, we can pass the data on to Power BI or another BI platform, and for learning materials to your LMS.

The cost is determined by the complexity of the data flows, the number of systems and schools to be integrated, the required synchronisation frequency and the amount of custom business logic. Ongoing maintenance, monitoring and support also affect the total investment. We always provide a clear quote after a no-obligation analysis of your situation.

Yes. A Somtoday integration processes data on students who are often minors, so privacy is central. Appfront builds in line with OWASP ASVS and the education privacy covenant: data minimisation, scoped and read-only access, OAuth tokens in secure vaults and clearly separated permissions per integration. We only process the data that is truly needed, document the data flows for your record of processing activities and set up the integration so that you can demonstrably comply with the GDPR.

Yes. Appfront regularly takes over the maintenance of existing integrations, even if they were originally set up by another party. We review the API integration, the OAuth configuration, the data flows and the error handling, document the current setup and draw up improvement proposals. From then on, we can handle changes, extensions and monitoring — including timely token rotation.

A Somtoday integration suits secondary schools, education groups, edtech builders and suppliers of additional education software who want to work with Somtoday data. Typical use cases: a parent or student portal with grades and timetables, a custom education app, an integration with an LMS or learning resources platform, and BI dashboards for school leadership and boards. For schools on Magister or in primary education, we will work with you to find the integration that fits best.

Ready to build your Somtoday integration?

Tell us which student, grade, timetable or absence data you want to unlock from Somtoday and which app, portal, LMS or BI environment it needs to go to — we're happy to advise on endpoints, scoped access and the route via the partner programme. A no-obligation initial conversation will give you a clear picture of the possibilities within half an hour.

Edit content