Booking on your website

Show your doctors and their free times on your clinic's own website. Patients pick a time there, then sign in or register with your clinic in the Rinova patient portal to book it.

Add it in three steps

  1. 1. Make a booking key

    In the Rinova portal, open Settings › Integrations and choose New key under Booking on your website. List the websites that will show booking, e.g. https://www.yourclinic.com. The key works only on those.

  2. 2. Paste the code

    Rinova shows the key once, with the code below already filled in. Paste it where the booking should appear on your website.

  3. 3. Patients book

    Visitors choose a day, a doctor and a time. The time opens in the patient portal, where they sign in or register and confirm.

The booking widget

Works on any website: WordPress, Wix, or plain HTML. It shows the next 14 days, lets visitors filter by department, specialty and in-person or video visits, and uses your clinic's time zone.

HTML
<div id="rinova-booking"></div>
<script src="https://rinova.health/widget/booking.js"
        data-key="rk_pub_your_key"
        async></script>
data-key
Your clinic's booking key. Required.
data-target
Where the widget goes, as a CSS selector. Default #rinova-booking.
data-lang
en (English) or bn (Bangla). Default en.
data-color
The colour of buttons and the chosen day, e.g. #1d4ed8.

Only doctors whose availability is active and set to show to the public appear. You control both on the doctor's availability in the portal.

Build your own with the booking API

If you have a developer, you can show free times in your own design. The API only reads; booking always happens in the patient portal.

Send your key with every request

JavaScript
fetch("https://api.rinova.health/api/v1/booking/practitioners-with-slots?date=2026-11-02", {
  headers: { "X-Api-Key": "rk_pub_your_key" },
}).then((r) => r.json());

Answers

JSON
{ "success": true, "data": { ... } }
{ "success": false, "error": "…", "code": "INVALID_API_KEY" }
GET /api/v1/booking/clinic
Your clinic's name, time zone, address, phone, logo and bookingUrl. Add &slotId=<id> to bookingUrl to open a chosen time in the patient portal.
GET /api/v1/booking/days?from=YYYY-MM-DD&days=14
How many free times there are on each day, for a day picker. Takes the same filters as the doctors list.
GET /api/v1/booking/specialties
The specialties of doctors who take online bookings.
GET /api/v1/booking/departments
Your departments that take online bookings, each with an id and a name.
GET /api/v1/booking/practitioners-with-slots?date=YYYY-MM-DD
Doctors with their free times on that day (in your clinic's time zone), each with their degrees, specialty and department. Optional: specialty, department (an id from the departments list), locationType (physical, virtual or both), _count (up to 20) and _offset.
GET /api/v1/booking/slots/:slotId
One free time, with its doctor and place.

When something goes wrong

401 API_KEY_REQUIRED
No X-Api-Key header was sent.
401 INVALID_API_KEY
The key is wrong or was revoked. Make a new one in Settings.
403 ORIGIN_NOT_ALLOWED
The page's website is not listed on the key. Add it under the key's websites.
429 RATE_LIMIT_EXCEEDED
Too many requests from one visitor. Wait a few minutes.

Keeping your key safe

  • The key sits in your website's page, so anyone can see it. That is expected: it only shows the free times your website already shows, and browsers can use it only on the websites you listed.
  • It can't book, change or see appointments or patients.
  • If a key is misused, revoke it in Settings › Integrations. Websites using it stop showing times within a minute. Make a new key and update your website's code.

Everything Rinova connects to

Let patients find a time on your website.

Make a key in Settings and paste the code. Talk to us if you would like help adding it.