Individual Appointment

IndividualAppointment

object
archived_at
string or null <date-time>
object
booking_ip_address
string or null <ipv4>
object
cancellation_note
string or null
cancellation_reason
integer or null
cancellation_reason_description
string or null
Enum: "Feeling Better" "Condition Worse" "Sick" "COVID-19 related" "Away" "Other" "Work"
cancelled_at
string or null <date-time>
object or null
created_at
string <date-time>
deleted_at
string or null <date-time>
did_not_arrive
boolean or null
email_reminder_sent
boolean or null
ends_at
string <date-time>
has_patient_appointment_notes
boolean or null
id
string <int64>
invoice_status
integer or null
object
notes
string or null
online_booking_policy_accepted
boolean or null
object
patient_arrived
boolean or null
object
patient_name
string or null
object
object or null
object
object or null
sms_reminder_sent
boolean or null
starts_at
string <date-time>
telehealth_url
string or null <uri>
treatment_note_status
integer or null
updated_at
string <date-time>
{}

List individual appointments

get/individual_appointments
SecuritybasicAuth
Request
query Parameters
order
string
Deprecated
Enum: "asc" "desc"
page
integer
per_page
integer [ 1 .. 100 ]
q[]
Array of strings

Filter result by one or more fields.

See Filtering Results

Available filters:

Value Format
appointment_type_id int64
archived_at date-time
business_id int64
cancelled_at date-time
created_at date-time
deleted_at date-time
did_not_arrive boolean
ends_at date-time
id int64
patient_id int64
practitioner_id int64
repeated_from_id int64
starts_at date-time
updated_at date-time
sort
Array of strings

Comma separated search fields. See: Ordering

Example: sort=created_at:desc
Responses
200

successful operation

Request samples
Response samples
application/json
{}

Create individual appointment

post/individual_appointments
SecuritybasicAuth
Request
Request Body schema: application/json
appointment_type_id
string <int64>

appointment type id

business_id
string <int64>

business id

ends_at
string <date-time>

If not provided on create or set to null on update, this will be based on the duration of the appointment type.

notes
string or null
patient_case_id
string <int64>

patient case id

patient_id
string <int64>

patient id

practitioner_id
string <int64>

practitioner id

object or null
starts_at
string <date-time>
Responses
201

Resource was created

422

Resource could not be saved due to validation errors

Request samples
application/json
{
  • "appointment_type_id": "1",
  • "business_id": "1",
  • "ends_at": "2019-08-24T14:15:22Z",
  • "notes": "string",
  • "patient_id": "1",
  • "patient_case_id": "1",
  • "practitioner_id": "1",
  • "starts_at": "2019-08-24T14:15:22Z",
  • "repeat_rule": {
    • "number_of_repeats": 0,
    • "repeat_type": "Daily",
    • "repeating_interval": 0
    }
}
Response samples
application/json
{}

Get individual appointment

get/individual_appointments/{id}
SecuritybasicAuth
Request
path Parameters
id
required
string <int64>
query Parameters
q[]
Array of strings

Filter result by one or more fields.

See Filtering Results

Available filters:

Value Format
archived_at date-time
cancelled_at date-time
deleted_at date-time
Responses
200

Successful operation

Request samples
Response samples
application/json
{}

Update individual appointment

patch/individual_appointments/{id}
SecuritybasicAuth
Request
path Parameters
id
required
string <int64>
Request Body schema: application/json
appointment_type_id
string <int64>

appointment type id

business_id
string <int64>

business id

ends_at
string <date-time>

If not provided on create or set to null on update, this will be based on the duration of the appointment type.

notes
string or null
patient_case_id
string <int64>

patient case id

patient_id
string <int64>

patient id

practitioner_id
string <int64>

practitioner id

object or null
starts_at
string <date-time>
Responses
200

Resource was updated

422

Resource could not be saved due to validation errors

Request samples
application/json
{
  • "appointment_type_id": "1",
  • "business_id": "1",
  • "ends_at": "2019-08-24T14:15:22Z",
  • "notes": "string",
  • "patient_id": "1",
  • "patient_case_id": "1",
  • "practitioner_id": "1",
  • "starts_at": "2019-08-24T14:15:22Z",
  • "repeat_rule": {
    • "number_of_repeats": 0,
    • "repeat_type": "Daily",
    • "repeating_interval": 0
    }
}
Response samples
application/json
{}

Archive individual appointmentDeprecated

delete/individual_appointments/{id}
SecuritybasicAuth
Request
path Parameters
id
required
string <int64>
Responses
204

Resource was archived successfully

Request samples

Archive individual appointment

post/individual_appointments/{id}/archive
SecuritybasicAuth
Request
path Parameters
id
required
string <int64>
Responses
204

Resource was archived

Request samples

Cancel individual appointment

patch/individual_appointments/{id}/cancel
SecuritybasicAuth
Request
path Parameters
id
required
string <int64>
Request Body schema: application/json
apply_to_repeats
boolean
cancellation_note
string or null
cancellation_reason
integer
Enum Value Description
10 Feeling better
20 Condition worse
30 Sick
40 Away
50 Other
60 Work
Enum: 10 20 30 40 50 60
Responses
204

Resource was cancelled

Request samples
application/json
{
  • "cancellation_note": "string",
  • "cancellation_reason": 10,
  • "apply_to_repeats": true
}

Get conflicts for an individual appointment

get/individual_appointments/{id}/conflicts
SecuritybasicAuth
Request
path Parameters
id
required
string <int64>
Responses
200

Successful operation

Request samples
Response samples
application/json
{
  • "conflicts": {
    • "exist": true
    }
}