Skip to content

PracSuite API (v1)

This is the official PracSuite API.

It follows standard REST conventions, so you can work with it using any HTTP client and any programming language that can send HTTP requests.

All responses are returned in JSON format.

Download OpenAPI description
Overview
PracSuite API Support
License
Languages
Servers
Prod server
https://api.pracsuite.com/v1/

Appointment

SchemasOperations

Group Appointment

SchemasOperations

Group Appointment Member

SchemasOperations

Cancellation Reason

SchemasOperations

Reschedule Reason

SchemasOperations

Appointment Type

SchemasOperations

Appointment Status

SchemasOperations

Available Appointment

You may search for a maximum of 7 days of appointment availability per request.

All availability searches must specify a single appointment_type_id.

Availability may be filtered using any combination of business, practitioner, profession, or resource. When multiple filters are supplied, only times matching all provided criteria will be returned.

PracSuite users define daily practitioner availability using Rosters. Users can apply three availability flags to control which tools can book at particular times:

  • Manual - Allows staff to manually book appointments during these times
  • Online Booking - Allows these times to be booked through the PracSuite online booking system
  • Waiting List - Allows the PracSuite waiting list to offer these times to patients

Use the manual, online, and waiting_list query parameters to filter available times based on these roster flags. If none of these parameters are supplied, only times available for manual bookings will be returned.

Users define default appointment duration rules per Appointment Type. These defaults may vary based on business, profession, practitioner, and client fee category, which is determined by the combination of client_id and account_id.

When available, client_id and account_id should be provided to ensure the correct Appointment Type default configuration is applied.

SchemasOperations

Available Group Appointment

SchemasOperations

Available Group Appointment

appointment_idinteger
current_class_sizeinteger
max_class_sizeinteger
app_timestring(date-time)
column_numberinteger
item_idinteger
item_group_idinteger
appointment_type_idinteger
practitioner_idinteger
business_idinteger
profession_idinteger
widthinteger
durationinteger
resource_idsArray of integers
practitioner_namestring
{ "appointment_id": 0, "current_class_size": 0, "max_class_size": 0, "app_time": "2019-08-24T14:15:22Z", "column_number": 0, "item_id": 0, "item_group_id": 0, "appointment_type_id": 0, "practitioner_id": 0, "business_id": 0, "profession_id": 0, "width": 0, "duration": 0, "resource_ids": [ 0 ], "practitioner_name": "string" }

List available group appointments

Request

Security
x-api-key and A-api-key
Query
fromstring(date)required

Cannot be more than 7 days before the to parameter and cannot be before the current date in the tenant's time zone.

Example: from=2026-01-01
tostring(date)required

Cannot be more than 7 days after the from parameter and cannot be before the current date in the tenant's time zone.

Example: to=2026-01-07
appointment_type_idintegerrequired
business_idsArray of integers
practitioner_idsArray of integers
profession_idsArray of integers
pageinteger>= 1
Example: page=1
page_sizeinteger[ 1 .. 100 ]
Example: page_size=50
curl -i -X GET \
  'https://api.pracsuite.com/v1/available_group_appointments?from=2026-01-01&to=2026-01-07&appointment_type_id=0&business_ids=0&practitioner_ids=0&profession_ids=0&page=1&page_size=50' \
  -H 'A-api-key: YOUR_API_KEY_HERE' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

A list of group appts

Bodyapplication/json
available_timesArray of objects(AvailableGroupAppointment)
total_entriesinteger
linksobject
Response
application/json
{ "available_times": [ {} ], "total_entries": 0, "links": { "self": "https://api.pracsuite.com/v1/available_group_appointments?page=2&appointment_type_id=1&from=2025-01-01&to=2025-01-07", "previous": "https://api.pracsuite.com/v1/available_group_appointments?page=1&appointment_type_id=1&from=2025-01-01&to=2025-01-07", "next": "https://api.pracsuite.com/v1/available_group_appointments?page=3&appointment_type_id=1&from=2025-01-01&to=2025-01-07" } }

Get Next available group appointment time

Request

Security
x-api-key and A-api-key
Query
fromstring(date)required

Cannot be more than 7 days before the to parameter and cannot be before the current date in the tenant's time zone.

Example: from=2026-01-01
tostring(date)required

Cannot be more than 7 days after the from parameter and cannot be before the current date in the tenant's time zone.

Example: to=2026-01-07
appointment_type_idintegerrequired
business_idsArray of integers
practitioner_idsArray of integers
profession_idsArray of integers
curl -i -X GET \
  'https://api.pracsuite.com/v1/next_available_group_appointment?from=2026-01-01&to=2026-01-07&appointment_type_id=0&business_ids=0&practitioner_ids=0&profession_ids=0' \
  -H 'A-api-key: YOUR_API_KEY_HERE' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

Next Available Appt

Bodyapplication/json
available_timesArray of objects(AvailableGroupAppointment)
total_entriesinteger
linksobject
Response
application/json
{ "available_times": [ {} ], "total_entries": 0, "links": { "self": "https://api.pracsuite.com/v1/next_available_group_appointment?page=2&appointment_type_id=1&from=2025-01-01&to=2025-01-07" } }

Business

SchemasOperations

Fee Category

SchemasOperations

Item

SchemasOperations

Item Group

SchemasOperations

Patient

Patients are the people that book in for appointments.

When you're working with patient information, make sure you abide by the relevant regulations for security and privacy.

A couple of fields in the patient record deserve special consideration:

accepted_privacy_policy stores the patient's consent to the business's own privacy policy. Values can be null (no response), true (accepted) or false (rejected). Please consider how this may affect you storing information on this patient.

time_zone will contain a valid IANA time zone identifier if the patient's time zone has been set, or null if it hasn't. It can be set via the API, in which case it accepts IANA time zone identifiers.

SchemasOperations

Patient Account

Patient accounts

SchemasOperations

Practitioner

SchemasOperations

Profession

SchemasOperations

Pronoun

SchemasOperations

Resource

SchemasOperations

Sex

SchemasOperations