Skip to main content

Partner API Overview

The Doctolib "Partner API" lets approved partners connect their systems to Doctolib services. With this API, partners can view and manage some resources related to appointment booking.

It includes endpoints to get available calendars, view visit reasons, search for available time slots, create reservations, manage patients, and confirm appointments.

This API helps partner systems work with Doctolib more easily. It can be used to automate booking steps, keep useful information up to date, and provide a smooth experience for end users.

Main features​

With the Partner API, you can:

  • View the list of calendars you can access
  • Get the available visit reasons
  • Search for available time slots for a calendar, a visit reason, and a given period
  • Create a temporary reservation for an available time slot
  • Create or search for a patient linked to a calendar
  • Confirm an appointment using a reservation and a patient
  • View existing appointments

Authentication​

Access to the API is secure and only available to partners with valid credentials.

Data format​

The API uses JSON to send and receive data. Resources include calendars, patients, reservations, appointments and visit reasons.

Responses use a consistent structure to make them easier to process. Lists of resources can be paginated with the page[number] and page[size] parameters.

Using the documentation​

This documentation gives details about the available endpoints, expected parameters, request examples, and response models. In the API reference sections, you can also test some calls directly from the interface when the required authentication credentials are provided.

Before you start, read the guide pages to understand the key concepts, available environments, and authentication rules.