samedi Connect API
The samedi Connect API lets you build your own patient portal on top of samedi for Professionals: your application searches availabilities, books appointments, and manages them on behalf of patients, using a single API token issued by samedi.
This API is for integrators who build their own patient portal on top of samedi for Professionals.
This API is not designed for use by integrators who want to integrate their customers on MyPatientPortal (e.g. patient.samedi.de or tenant-specific portals).
For those use cases, please refer to the MyPatientPortal API documentation.
Getting access
Access is granted by samedi: contact us, and we issue an API token for your patient portal. See the Connect API reference for how the token is used.
Documentation map
This documentation follows five sections, each with a single job. Start at the top and move down.
Section | Read it when you want to… |
|---|---|
Learn how authentication, guest and user bookings, and the patient data objects fit together before you write code. | |
Follow one guided path to book your first appointment end to end. | |
Accomplish a specific task — reschedule, cancel, ASAP list, video consultation — once you know the basics. | |
Look up API-wide conventions: the authentication header, pagination, and error codes. | |
Receive real-time notifications about appointment changes instead of polling. |
Full endpoint reference (Swagger)
Every endpoint, parameter, and response schema is documented in the live Swagger UI at https://app.samedi.de/api-docs. The pages here explain and guide. Swagger is the authoritative reference.