Appointment Type
An appointment type is a type of appointment that a patient that can book with you.
The appointment type model
Properties
- Name
id- Type
- string
- Description
Unique identifier for the appointment type.
- Name
object- Type
- string
- Description
Always 'appointment_type'.
- Name
name- Type
- string
- Description
Name of the appointment type.
- Name
description- Type
- string
- Description
Description of the appointment type.
- Name
color- Type
- string
- Description
Color used to display this appointment type.
- Name
duration- Type
- number
- Description
Duration of the appointment type.
- Name
group- Type
- boolean
- Description
Whether this is a group appointment.
- Name
max_participants- Type
- number
- Description
Only applies if this is a group appointment. Max number of participants allowed in appointments of this appointment type.
- Name
interaction_type- Type
- string
- Description
Interaction type for appointments of this type.
video_callin_person
Possible values:- Name
status- Type
- string
- Description
Status of the appointment type.
activearchived
Possible values:- Name
location- Type
- object
- Description
Default location for appointments of this type.
Address of the appointment_type.
- Name
recurrence_rules- Type
- array of objects
- Description
Recurrence rules describing how appointments of this type repeat.
- Name
charge_while_booking- Type
- object
- Description
- Amount to charge the patient when they are booking an appointment of this appointment type
- Name
charge_after_appointment- Type
- object
- Description
- Amount to charge the patient once appointments of this appointment type is successfully completed
- Name
bookable_by_patients- Type
- boolean
- Description
Whether patients can self-book appointments of this type.
- Name
min_appointment_gap- Type
- number
- Description
Minimum gap (in minutes) required between appointments of this type.
- Name
min_notice- Type
- number
- Description
Minimum notice (in minutes) required to book this type of appointment.
- Name
max_appointments_bookable- Type
- number
- Description
Maximum number of appointments of this type that can be booked.
- Name
show_provider_names- Type
- boolean
- Description
Whether provider names are shown to patients when booking.
- Name
auto_confirm- Type
- boolean
- Description
Whether appointments of this type are automatically confirmed when booked.
- Name
patient_instructions- Type
- string
- Description
Instructions shown to patients for this appointment type.
- Name
note_template- Type
- string
- Description
Visit note template used for appointments of this type.
- Name
usable_by- Type
- object
- Description
Configuration controlling which patients or groups can use this appointment type.
- Name
order- Type
- number
- Description
Display order of this appointment type.
- Name
settings- Type
- object
- Description
- Settings for the appointment type.
- Name
status_history- Type
- array of objects
- Description
- Status history of the appointment_type.
- Name
created_by- Type
- string
- Description
Creator of the appointment type.
- Name
created_at- Type
- number
- Description
Timestamp (in ISO 8601 format) of when the appointment type was created.
- Name
last_updated_at- Type
- number
- Description
Timestamp (in ISO 8601 format) of when the appointment type was last updated.
Response
{
"id": "aptp_3XxtAULYUrX7GVsTKePy",
"object": "appointment_type",
"name": "Annual Check-in",
"description": "Annual check-in appointment for all patients",
"duration": 30,
"group": false,
"charge_while_booking": {
"enabled": true,
"auto_charge_if_possible": true,
"product": "prod_3XxtAULYUrX7GVsTKePy",
},
"charge_after_appointment": {
"enabled": false
},
"settings": {
"bookable_by_patient": true,
"required_buffer": 30,
"specific_license_types_required": true,
"license_types_required": ["MD"],
"care_team_required": false,
},
"created_by": "user_xeDpGyt67wTor93qKtS7",
"created_at": "2024-04-03T04:12:01.781Z",
"last_updated_at": "2024-04-03T04:12:01.781Z"
}
Create an appointment type
Creates a new appointment type.
Required attributes
- Name
name- Type
- string
- Description
Name of the appointment type.
- Name
duration- Type
- number
- Description
Duration of the appointment type.
- Name
group- Type
- boolean
- Description
Whether this is a group appointment.
- Name
max_participants- Type
- number
- Description
Only applies if this is a group appointment. Max number of participants allowed in appointments of this appointment type.
- Name
charge_while_booking- Type
- object
- Description
- Amount to charge the patient when they are booking the appointment
- Name
charge_after_appointment- Type
- object
- Description
- Amount to charge the patient once the appointment is successfully completed
- Name
settings- Type
- object
- Description
- Settings for the appointment type.
- Name
created_by- Type
- string
- Description
Creator of the appointment type.
Optional attributes
- Name
description- Type
- string
- Description
Description of the appointment type.
Response
{
"id": "aptp_3XxtAULYUrX7GVsTKePy",
"object": "appointment_type",
"name": "Annual Check-in",
"description": "Annual check-in appointment for all patients",
"duration": 30,
"group": false,
"charge_while_booking": {
"enabled": true,
"auto_charge_if_possible": true,
"product": "prod_3XxtAULYUrX7GVsTKePy",
},
"charge_after_appointment": {
"enabled": false
},
"settings": {
"bookable_by_patient": true,
"required_buffer": 30,
"specific_license_types_required": true,
"license_types_required": ["MD"],
"care_team_required": false,
},
"created_by": "user_xeDpGyt67wTor93qKtS7",
"created_at": "2024-04-03T04:12:01.781Z",
"last_updated_at": "2024-04-03T04:12:01.781Z"
}
Retrieve an appointment type
Retrieves the specified appointment type.
Response
{
"id": "aptp_3XxtAULYUrX7GVsTKePy",
"object": "appointment_type",
"name": "Annual Check-in",
"description": "Annual check-in appointment for all patients",
"duration": 30,
"group": false,
"charge_while_booking": {
"enabled": true,
"auto_charge_if_possible": true,
"product": "prod_3XxtAULYUrX7GVsTKePy",
},
"charge_after_appointment": {
"enabled": false
},
"settings": {
"bookable_by_patient": true,
"required_buffer": 30,
"specific_license_types_required": true,
"license_types_required": ["MD"],
"care_team_required": false,
},
"created_by": "user_xeDpGyt67wTor93qKtS7",
"created_at": "2024-04-03T04:12:01.781Z",
"last_updated_at": "2024-04-03T04:12:01.781Z"
}
Update an appointment type
Updates the specified appointment type object by setting the values of the parameters passed. Any other parameters not provided will not be modified. Can only update appointment types that are not associated with any appointments.
Required attributes
- Name
updated_by- Type
- string
- Description
Updates to the appointment type made by.
Optional attributes
- Name
name- Type
- string
- Description
Name of the appointment type.
- Name
description- Type
- string
- Description
Description of the appointment type.
- Name
duration- Type
- number
- Description
Duration of the appointment type.
- Name
group- Type
- boolean
- Description
Whether this is a group appointment.
- Name
max_participants- Type
- number
- Description
Only applies if this is a group appointment. Max number of participants allowed in appointments of this appointment type.
- Name
charge_while_booking- Type
- object
- Description
- Amount to charge the patient when they are booking the appointment
- Name
charge_after_appointment- Type
- object
- Description
- Amount to charge the patient once the appointment is successfully completed
- Name
settings- Type
- object
- Description
- Settings for the appointment type.
Response
{
"id": "aptp_3XxtAULYUrX7GVsTKePy",
"object": "appointment_type",
"name": "Annual Check-in",
"description": "Annual check-in appointment for all patients",
"duration": 30,
"group": false,
"charge_while_booking": {
"enabled": true,
"auto_charge_if_possible": true,
"product": "prod_3XxtAULYUrX7GVsTKePy",
},
"charge_after_appointment": {
"enabled": false
},
"settings": {
"bookable_by_patient": true,
"required_buffer": 30,
"specific_license_types_required": true,
"license_types_required": ["MD"],
"care_team_required": false,
},
"created_by": "user_xeDpGyt67wTor93qKtS7",
"created_at": "2024-04-03T04:12:01.781Z",
"last_updated_at": "2024-04-03T04:12:01.781Z"
}
List all appointment types
Returns a list of all appointment types.
Response
{
"object": "list",
"data": [
{
"id": "aptp_3XxtAULYUrX7GVsTKePy",
"object": "appointment_type",
"name": "Annual Check-in",
"description": "Annual check-in appointment for all patients",
"duration": 30,
"group": false,
"charge_while_booking": {
"enabled": true,
"auto_charge_if_possible": true,
"product": "prod_3XxtAULYUrX7GVsTKePy",
},
"charge_after_appointment": {
"enabled": false
},
"settings": {
"bookable_by_patient": true,
"required_buffer": 30,
"specific_license_types_required": true,
"license_types_required": ["MD"],
"care_team_required": false,
},
"created_by": "user_xeDpGyt67wTor93qKtS7",
"created_at": "2024-04-03T04:12:01.781Z",
"last_updated_at": "2024-04-03T04:12:01.781Z"
},
]
}
Delete an appointment type
Deletes the specified appointment type. Appointment type cannot be deleted if it is associated with any appointments.
Required attributes
Optional attributes
Response
{
"id": "aptp_2UxtAULYUrX7GVsTKePy",
"object": "appointment_type",
"delete": true
}