Book Doctolib appointment
Input
motive_id requiredVisit motive id, from list_slots.visit_motives.
start_date requiredSlot start, exactly as list_slots returns it, e.g. 2027-01-07T12:30:00.000+01:00.
profile_path requiredProfile path with ?pid=practice-N, from search_practitioners or list_slots.
confirm optionalfalse: stop at checkout, the slot held for 15 minutes. true: book the slot.
Default: falsenew_patient optionaltrue when the patient has never consulted this practitioner. Needed only when Doctolib asks (asks_new_patient in the checkout result).
Output
stage requiredquestions requiredOther required questions Doctolib asks before it books. The script cannot answer them, so a booking with questions fails.
start_date requiredSlot the checkout holds.
appointment requiredThe booked appointment (stage booked); null at checkout.
asks_new_patient requiredDoctolib asks whether the patient has consulted this practitioner before: pass new_patient.
price optionalAmount to pay at booking, when Doctolib asks for one.
motive optionaladdress optionalpatient optionalThe account holder the appointment is for.
telehealth optionalpractitioner optionalprofile_path optionalFAQ
Search Doctolib practitioners
Search Doctolib practitioners by specialty and location. Returns total, page, and providers with full_name, specialty, address, sector, payment_means, languages, telehealth, online_booking, matched_visit_motive, and profile_path. There are 20 providers per page and the order is server-ranked; profile_path (including ?pid=practice-N) is the join key for get_practitioner and list_slots.
List Doctolib slots
List a Doctolib practitioner's bookable appointment slots for one visit motive over a window of up to 15 days (Doctolib's limit); for a longer span, call again with a later start_date. Returns name, motive, bookable, availabilities (slots by day), total, next_slot (the next slot after an empty window), visit_motives, and booking_url. A motive name that matches several motives, an unknown motive id or an unknown profile fails with a message saying what to pass; pass motive_id to target one motive exactly. booking_url only opens the booking funnel; there is no per-slot link.
List Doctolib appointments
List the appointments of the signed-in Doctolib account, upcoming or past, as the account's appointments page shows them. Each appointment has its id (the one Cancel Doctolib appointment takes), start and end date, practitioner, speciality, profile path, visit motive, patient, and whether it is confirmed, canceled, past or a no-show. Past appointments come 10 at a time, newest first: pass next_cursor back as cursor for the next ones, until it comes back null. Doctolib removes old appointments from the history after some years. No appointment returns an empty list.