[#1351] practitioner availability through API

Migrated from Redmine #1351 | Author: Neil Jones
Status: New | Priority: High, I’m very impatient | Created: 2025-02-05


We want to use simply book as our booking engine. we run a group of dental practices and we want to collect all our practitioner diary availabilty through our CRM’s API and display this availablity in the simplybooks calendar.

Ideally we want the user to select a time slot that they would like to book then we would like to give them an option on which practitioner they would like to book in that time slot.

Is this possible?

Here is the API documentation
*
This request will return all practitioner diaries*
DEFINITION

GET https://api.dentally.co/v1/rota_practitioner_diaries?{after, before, practitioner_id, site_id}
EXAMPLE REQUEST

curl https://api.dentally.co/v1/rota_practitioner_diaries?after=2021-08-21&before=2021-08-25
EXAMPLE RESPONSE:

{
“rota_practitioner_diaries”: [
{
“id”: “d6df1c88-b9b2-423d-8de8-62027e0ba0ab”,
“day”: “2021-08-23”,
“end_time”: “2021-08-23T15:00:00.000+01:00”,
“start_time”: “2021-08-23T10:00:00.000+01:00”,
“unavailable”: false,
“practitioner_id”: “1”,
“breaks”: [
{
“id”: “8c9c7d2a-6d1a-4786-98aa-2cbd6f1af3df”,
“name”: “Lunch”,
“start_time”: “2021-08-23T12:00:00.000+01:00”,
“end_time”: “2021-08-23T13:00:00.000+01:00”
},
{
“id”: “767dcafb-0e13-45dd-9c55-c3f1f47eca38”,
“name”: “Tea”,
“start_time”: “2021-08-23T15:00:00.000+01:00”,
“end_time”: “2021-08-23T15:15:00.000+01:00”
}
]
}
],

This call will return All availability

DEFINITION

GET https://api.dentally.co/v1/appointments/availability?{start_time,finish_time,duration,practitioner_ids}
EXAMPLE REQUEST

curl “https://api.dentally.co/v1/appointments/availability?practitioner_ids[]=1&duration=5&start_time=2015-01-07T12:00:11+00:00&finish_time=2015-02-06T12:00:11+00:00
EXAMPLE RESPONSE:

{
“availability”: [
{
“start_time”: “2015-01-07T12:00:00.000+00:00”,
“finish_time”: “2015-01-07T14:20:00.000+00:00”,
“available_duration”: 140
},
{
“start_time”: “2015-01-07T14:40:00.000+00:00”,
“finish_time”: “2015-01-07T17:00:00.000+00:00”,
“available_duration”: 140
},
{…}
],
“meta”: {
“page”: 1
}
}
“meta”: {
“total”: 1,
“current_page”: 1,
“total_pages”: 1
}
}

The full API documentation is available here: Dentally API
Thanks

Redmine Admin wrote:

hi, you can simply install a simplybook widget to your CRM

API integration is possible, however it will require development and testing.

Neil Jones wrote:

Thanks, Can you share some further information on how to “install a simplybook widget to your CRM”

Redmine Admin wrote:

hi, you can simply install a simplybook widget to your CRM

API integration is possible, however it will require development and testing.

Redmine Admin wrote:

hi, you can simply install a simplybook widget to your CRM

API integration is possible, however it will require development and testing.

Redmine Admin wrote:

hi, you can simply install a simplybook widget to your CRM

API integration is possible, however it will require development and testing.

Redmine Admin wrote:

hi, you can simply install a simplybook widget to your CRM

API integration is possible, however it will require development and testing.