vCita Appointments API
The Appointments API from vCita — 3 operation(s) for appointments.
The Appointments API from vCita — 3 operation(s) for appointments.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/vcita:vcita-appointments-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Scheduling Appointments API
description: Unified OpenAPI specification for scheduling domain
version: '3.0'
x-generated:
sourceFiles:
- legacy_v1_scheduling.json
- scheduling.json
- availability.json
- availability_slots.json
- resource_management.json
pathNormalizations:
- file: legacy_v1_scheduling.json
basePath: /platform/v1
transformations:
- original: /scheduling/appointments
normalized: /platform/v1/scheduling/appointments
basePath: /platform/v1
- original: /scheduling/appointments/{appointment_id}
normalized: /platform/v1/scheduling/appointments/{appointment_id}
basePath: /platform/v1
- original: /scheduling/bookings
normalized: /platform/v1/scheduling/bookings
basePath: /platform/v1
- original: /scheduling/bookings/cancel
normalized: /platform/v1/scheduling/bookings/cancel
basePath: /platform/v1
- original: /scheduling/bookings/{booking_uid}/update_rsvp_state
normalized: /platform/v1/scheduling/bookings/{booking_uid}/update_rsvp_state
basePath: /platform/v1
- original: /scheduling/event_attendances/{event_attendance_uid}
normalized: /platform/v1/scheduling/event_attendances/{event_attendance_uid}
basePath: /platform/v1
- original: /scheduling/event_instance/{event_instance_id}
normalized: /platform/v1/scheduling/event_instance/{event_instance_id}
basePath: /platform/v1
- original: /scheduling/scheduling_forms/get_form
normalized: /platform/v1/scheduling/scheduling_forms/get_form
basePath: /platform/v1
- original: /scheduling/waitlist
normalized: /platform/v1/scheduling/waitlist
basePath: /platform/v1
- original: /scheduling/waitlist/cancel
normalized: /platform/v1/scheduling/waitlist/cancel
basePath: /platform/v1
- original: /services
normalized: /platform/v1/services
basePath: /platform/v1
- original: /staff/availability
normalized: /platform/v1/staff/availability
basePath: /platform/v1
- file: scheduling.json
basePath: /business/scheduling
transformations:
- original: /v1/appointments
normalized: /business/scheduling/v1/appointments
basePath: /business/scheduling
- original: /v1/bookings
normalized: /business/scheduling/v1/bookings
basePath: /business/scheduling
- original: /v1/bookings/accept
normalized: /business/scheduling/v1/bookings/accept
basePath: /business/scheduling
- original: /v1/bookings/cancel
normalized: /business/scheduling/v1/bookings/cancel
basePath: /business/scheduling
- original: /v1/bookings/complete
normalized: /business/scheduling/v1/bookings/complete
basePath: /business/scheduling
- original: /v1/bookings/{booking_id}
normalized: /business/scheduling/v1/bookings/{booking_id}
basePath: /business/scheduling
- original: /v1/external_calendar_items/bulk_create
normalized: /business/scheduling/v1/external_calendar_items/bulk_create
basePath: /business/scheduling
- original: /v1/external_calendar_items/bulk_deactivate
normalized: /business/scheduling/v1/external_calendar_items/bulk_deactivate
basePath: /business/scheduling
- original: /v1/external_calendar_items/connect
normalized: /business/scheduling/v1/external_calendar_items/connect
basePath: /business/scheduling
- original: /v1/external_calendar_items/deactivate_external_calendar
normalized: /business/scheduling/v1/external_calendar_items/deactivate_external_calendar
basePath: /business/scheduling
- original: /v1/external_calendar_items/disable
normalized: /business/scheduling/v1/external_calendar_items/disable
basePath: /business/scheduling
- original: /v1/external_calendar_items/disconnect
normalized: /business/scheduling/v1/external_calendar_items/disconnect
basePath: /business/scheduling
- original: /v1/external_calendar_items/report_sync_status
normalized: /business/scheduling/v1/external_calendar_items/report_sync_status
basePath: /business/scheduling
- original: /v1/external_calendar_items/start_export
normalized: /business/scheduling/v1/external_calendar_items/start_export
basePath: /business/scheduling
- original: /v1/external_calendar_items/stop_import
normalized: /business/scheduling/v1/external_calendar_items/stop_import
basePath: /business/scheduling
- original: /v1/time_slots
normalized: /business/scheduling/v1/time_slots
basePath: /business/scheduling
- original: /v1/time_slots/{time_slot_uid}
normalized: /business/scheduling/v1/time_slots/{time_slot_uid}
basePath: /business/scheduling
pathConflicts: []
componentConflicts: []
totalPaths: 35
totalComponents: 4
servers:
- url: https://api.vcita.biz
description: Unified API Gateway server
tags:
- name: Appointments
paths:
/business/scheduling/v1/appointments:
post:
description: '## Overview
Create one or more appointments on the business calendar. Available for **Staff tokens**.
Each element of `appointments` is a complete appointment definition, so several appointments — including the occurrences of a recurring series — can be created in a single request. The created appointments are returned under `data.appointments`, in the order they were sent.
Appointments are booked for an existing client: look up the client, service and staff member first, then send their uids in `client_id`, `service_id` and `staff_id`.'
parameters: []
responses:
'200':
description: Appointments Created
content:
application/json:
example:
data:
appointments:
- approval_mode: null
business_uid: 104a5664c3663a8d
category_name: null
charge_type: no_price
client_first_name: Deeanna
client_id: bnv869hpj1kl5v35
client_last_name: Rice
conversation_id: uqleye8ammpbuvxl
created_at: '2026-04-01T09:12:04.020Z'
currency: ILS
duration: 30
end_time: '2026-04-02T14:30:00.000Z'
id: e7j16p8hrgacto4g
interaction_details: 0543033109
interaction_type: client_phone
is_recurring: false
no_show: false
notes: null
payment_id: null
payment_status: null
price: '0.0'
series_id: null
service_id: h5ak3dj8782zf4g9
staff_display_name: Britt Bogan
staff_id: gzk1di5ocdkdjv0j
start_time: '2026-04-02T14:00:00.000Z'
state: scheduled
title: Introductory phone call
type: appointment
updated_at: '2026-04-01T09:12:04.020Z'
status: OK
'422':
description: Appointment Creation Failure - validation error such as an unavailable time slot, a staff member who does not offer the service, or a missing required field
content:
application/json:
example:
error: The requested time slot is not available
error_code: TIMESLOT_UNAVAILABLE
status: Error
summary: Create Appointments [Business]
tags:
- Appointments
x-amazon-apigateway-auth:
type: NONE
x-amazon-apigateway-integration:
httpMethod: POST
responses:
default:
statusCode: '200'
type: http_proxy
uri: https:///business/scheduling/v1/appointments
x-auth-type: Application & Application User
requestBody:
content:
application/json:
schema:
properties:
appointments:
description: The appointments to create. Send one element per appointment; at least one is required.
items:
properties:
additional_staffs:
description: Uids of further staff members to attach to the appointment, in addition to `staff_id`.
type: string
x-reference-to: staff
agenda:
description: Free-text agenda or notes for the appointment.
type: string
approval_mode:
description: Whether the appointment needs staff approval before it is confirmed. Omit to use the approval setting configured on the service.
type: string
auto_follow_up_hours:
description: How many hours after the appointment ends to send an automatic follow-up message. Omit to send none.
type: number
auto_redeem:
description: Set to `true` to redeem one session from the client's matching package instead of charging for the appointment.
type: boolean
charge_type:
description: How the appointment is priced. `no_price` creates a free appointment, `fixed` charges the price configured on the service, and `custom` charges the amount sent in `price`.
enum:
- no_price
- fixed
- custom
type: string
client_id:
description: Uid of the client the appointment is booked for. Always required — this endpoint books for an existing client and does not create one.
type: string
x-reference-to: client
currency:
description: ISO 4217 currency code for `price`, for example `USD` or `ILS`. Send it whenever `price` is set.
type: string
end_time:
description: When the appointment ends. Always required. Interpreted in the business time zone exactly like `start_time`. Unless a different length was requested, set it to `start_time` plus the duration configured on the service.
type: string
future_bookings_limit:
description: How far ahead this appointment may be booked. Send `0` for no limit.
type: integer
interaction_details:
description: 'Contact details or location for the meeting. What to send depends on `interaction_type`:
- `client_phone` — the client''s phone number
- `business_phone` — the business phone number
- `client_location` — the client''s address
- `business_location`, `default_business_location` — the business address
- `online`, `zoom`, `video_room`, `conference_bridge`, `skype` — send an empty string; the meeting link is generated for you
Required whenever the interaction type needs a value. If the value is missing from the client record, ask the caller for it rather than guessing.'
type: string
interaction_type:
description: How the meeting takes place. Copy the value from the service's own `interaction_type` rather than picking one; ask the caller only when the service does not define one. This value determines what `interaction_details` must contain.
enum:
- zoom
- video_room
- skype
- business_phone
- conference_bridge
- business_location
- default_business_location
- online
- client_location
- client_phone
type: string
is_recurring:
description: Set to `true` when the appointment is one occurrence of a recurring series.
type: boolean
matter_uid:
description: Uid of the matter (conversation) the appointment belongs to. Send it to file the appointment under an existing conversation with the client.
type: string
x-reference-to: matter
meeting_reminder_sms_1:
description: Set to `true` to send the first reminder by SMS.
type: boolean
meeting_reminder_sms_2:
description: Set to `true` to send the second reminder by SMS.
type: boolean
min_hours_before_meeting:
description: How many hours before the start time the client may still reschedule or cancel. Omit to use the setting configured on the service.
type: integer
mobile:
description: Set to `true` when the appointment is being created from a mobile client.
type: boolean
padding:
description: Buffer time in minutes to block after the appointment ends, keeping the slot free for travel or clean-up.
type: integer
price:
description: The amount to charge for the appointment. Send it together with a `charge_type` of `custom`. Leave it null when `charge_type` is `no_price`.
type: number
remind_before_in_hours_1:
description: How many hours before the start time to send the first reminder.
type: number
remind_before_in_hours_2:
description: How many hours before the start time to send the second reminder. Send `0` to disable it.
type: number
require_confirmation:
description: Set to `true` to ask the client to confirm the appointment before it is treated as booked.
type: boolean
resource_uids:
description: Uids of the resources — rooms, equipment and the like — to reserve for the appointment.
items:
type: string
type: array
x-reference-to: resource
service_id:
description: Uid of the service being booked. Always required. The service supplies the defaults for `end_time`, `charge_type` and `interaction_type`, so read it first when deriving those.
type: string
x-reference-to: service
set_arrival_window_as_default:
description: Set to `true` to save this appointment's arrival window as the default for the service, so future bookings reuse it.
type: boolean
sms_booking_confirmation:
description: Set to `true` to send the client an SMS confirmation as soon as the appointment is created.
type: boolean
source_type:
description: Who initiated the appointment. Use `initiated_by_staff` when a staff member books on the client’s behalf, and `initiated_by_client` when the client booked it themselves.
enum:
- initiated_by_staff
- initiated_by_client
type: string
staff_id:
description: Uid of the staff member who will provide the service. Always required. The staff member must already offer `service_id`, otherwise the request is rejected with "The provided staff member doesn't offer the provided service".
type: string
x-reference-to: staff
start_time:
description: When the appointment starts. Always required. The value is interpreted in the **business time zone even when it carries a `Z` suffix** — `2026-04-01T13:00:00.000Z` books 1pm business-local, not 1pm UTC. Send the wall-clock time you want and do not convert it to UTC first.
type: string
tax_uids:
description: Uids of the taxes to apply to the appointment price. Only relevant when the appointment is charged.
items:
type: string
type: array
x-reference-to: tax
title:
description: Title shown on the calendar entry. Always required. Use the service name unless a more specific title was requested.
type: string
required:
- client_id
- service_id
- staff_id
- start_time
- end_time
- title
type: object
type: array
new_api:
default: true
description: Selects the current request format for this endpoint. Always send `true`.
type: boolean
unified_payment_link:
description: Set to `true` to generate a single payment link covering every appointment created by this request, instead of a separate link per appointment.
type: boolean
required:
- appointments
- new_api
type: object
security:
- Bearer: []
operationId: postBusinessSchedulingV1Appointments
x-operation-id-source: derived
/platform/v1/scheduling/appointments:
get:
description: '## Overview
Retrieves a paginated list of appointments for the business. Supports filtering by client, appointment state, and sorting.
## Booking note
Appointments are the scheduled items on the business calendar. To **create** an appointment (and to handle client lifecycle actions such as reschedule/cancel), use the Bookings endpoints (for example: `POST /platform/v1/scheduling/bookings`).
Available for **Staff and Application tokens**.'
parameters:
- description: Business ID (optional)
in: query
name: business_id
required: false
schema:
type: string
- description: Client ID Filter
in: query
name: client_id
required: false
schema:
type: string
- description: State Filter - rejected/scheduled/done/cancelled/pending_reschedule/reschedule e.g state=done,rejected
in: query
name: state
required: false
schema:
type: string
- description: Multiple order by option - updated:DESC,start_at:ASC,created:DESC
in: query
name: sort
required: false
schema:
type: string
- description: 'Page number of results. Default: 1'
in: query
name: page
required: false
schema:
type: integer
- description: 'How many items to return per page. Default: 25. Max: 100'
in: query
name: per_page
required: false
schema:
type: integer
responses:
'200':
description: Success
content:
application/json:
example:
data:
appointments:
- approval_mode: null
business_uid: 104a5664c3663a8d
category_name: null
charge_type: no_price
client_color_id: 0
client_first_name: Deeanna
client_id: xvl55kzldujkar76
client_last_name: Rice
conversation_id: c7g4pvubtj84j6b5
created_at: '2025-08-05T06:56:16.020Z'
currency: null
duration: 30
end_time: '2025-08-11T06:30:00.000Z'
id: e7j16p8hrgacto4g
image_url: ''
initiator: null
interaction_details: consequuntur
interaction_type: client_location
is_recurring: false
linked_booking_uid: null
no_show: false
notes: null
optional_times: []
payment_id: null
payment_status: null
price: '0.0'
series_id: null
series_instance_count: null
service_id: vxolrre9o6ob92ee
staff_display_name: Britt Bogan
staff_id: 9a33fc142dbb67f3
staff_image: null
start_time: '2025-08-11T06:00:00.000Z'
state: scheduled
title: Advanced didactic portal
type: appointment
updated_at: '2025-08-05T06:56:16.020Z'
next_page: null
status: OK
summary: Get Appointments List
tags:
- Appointments
x-amazon-apigateway-auth:
type: NONE
x-amazon-apigateway-integration:
httpMethod: GET
responses:
default:
statusCode: '200'
type: http_proxy
uri: https:///platform/v1/scheduling/appointments
x-auth-type: Application & Application User
security:
- Bearer: []
operationId: getPlatformV1SchedulingAppointments
x-operation-id-source: derived
/platform/v1/scheduling/appointments/{appointment_id}:
get:
description: '## Overview
Get appointment details by ID.
## Booking note
If your goal is to **create** appointments or manage client lifecycle actions (reschedule/cancel), look for the Bookings endpoints (for example: `POST /platform/v1/scheduling/bookings`).
Available for **Staff and Application tokens**.'
parameters:
- description: Appointment id
in: path
name: appointment_id
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
example:
data:
appointment:
approval_mode: null
auto_follow_up_hours: 0
business_uid: 104a5664c3663a8d
category_name: null
charge_type: no_price
client_color_id: 0
client_first_name: Deeanna
client_id: xvl55kzldujkar76
client_last_name: Rice
conversation_id: c7g4pvubtj84j6b5
coupon: null
created_at: '2025-08-05T06:56:16.020Z'
currency: null
duration: 30
end_time: '2025-08-11T06:30:00.000Z'
id: e7j16p8hrgacto4g
state: scheduled
title: Advanced didactic portal
type: appointment
updated_at: '2025-08-05T06:56:16.020Z'
status: OK
summary: Get Appointment
tags:
- Appointments
x-amazon-apigateway-auth:
type: NONE
x-amazon-apigateway-integration:
httpMethod: GET
responses:
default:
statusCode: '200'
type: http_proxy
uri: https:///platform/v1/scheduling/appointments/{appointment_id}
x-auth-type: Application & Application User
security:
- Bearer: []
operationId: getPlatformV1SchedulingAppointmentsByAppointmentId
x-operation-id-source: derived
components:
securitySchemes:
Bearer:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Provide a valid bearer token in the Authorization header. Example: ''Authorization: Bearer {app_token}'''
x-provenance:
method: searched
source: https://developers.intandem.tech:443/reference
harvested: '2026-11-15'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://developers.intandem.tech/reference/delete_business-scheduling-v1-time-slots-time-slot-uid.md
- https://developers.intandem.tech/reference/delete_v3-scheduling-resource-types-uid.md
- https://developers.intandem.tech/reference/delete_v3-scheduling-resources-uid.md
- https://developers.intandem.tech/reference/get_platform-v1-scheduling-appointments-appointment-id.md
- https://developers.intandem.tech/reference/get_platform-v1-scheduling-appointments.md
- https://developers.intandem.tech/reference/get_platform-v1-scheduling-bookings.md
- https://developers.intandem.tech/reference/get_platform-v1-scheduling-event-attendances-event-attendance-uid.md
- https://developers.intandem.tech/reference/get_platform-v1-scheduling-event-instance-event-instance-id.md
- https://developers.intandem.tech/reference/get_platform-v1-scheduling-scheduling-forms-get-form.md
- https://developers.intandem.tech/reference/get_platform-v1-services-1.md
- https://developers.intandem.tech/reference/get_platform-v1-staff-availability.md
- https://developers.intandem.tech/reference/get_v3-scheduling-availability-slots.md
- https://developers.intandem.tech/reference/get_v3-scheduling-resource-types-uid.md
- https://developers.intandem.tech/reference/get_v3-scheduling-resource-types.md
- https://developers.intandem.tech/reference/get_v3-scheduling-resources-uid.md
- https://developers.intandem.tech/reference/get_v3-scheduling-resources.md
- https://developers.intandem.tech/reference/post_business-scheduling-v1-appointments.md
- https://developers.intandem.tech/reference/post_business-scheduling-v1-bookings-accept.md
- https://developers.intandem.tech/reference/post_business-scheduling-v1-bookings-complete.md
- https://developers.intandem.tech/reference/post_business-scheduling-v1-bookings.md
- https://developers.intandem.tech/reference/post_business-scheduling-v1-time-slots.md
- https://developers.intandem.tech/reference/post_platform-v1-scheduling-bookings-cancel.md
- https://developers.intandem.tech/reference/post_platform-v1-scheduling-bookings.md
- https://developers.intandem.tech/reference/post_platform-v1-scheduling-waitlist.md
- https://developers.intandem.tech/reference/post_v3-scheduling-resource-types.md
- https://developers.intandem.tech/reference/post_v3-scheduling-resources.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-bookings-booking-id.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-bookings-cancel.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-external-calendar-items-bulk-create.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-external-calendar-items-bulk-deactivate.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-external-calendar-items-connect.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-external-calendar-items-deactivate-external-calendar.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-external-calendar-items-disable.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-external-calendar-items-disconnect.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-external-calendar-items-report-sync-status.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-external-calendar-items-start-export.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-external-calendar-items-stop-import.md
- https://developers.intandem.tech/reference/put_business-scheduling-v1-time-slots-time-slot-uid.md
- https://developers.intandem.tech/reference/put_platform-v1-scheduling-bookings-booking-uid-update-rsvp-state.md
- https://developers.intandem.tech/reference/put_platform-v1-scheduling-waitlist-cancel.md
- https://developers.intandem.tech/reference/put_v3-scheduling-resource-types-uid.md
- https://developers.intandem.tech/reference/put_v3-scheduling-resources-uid.md
- https://developers.intandem.tech:443/reference/delete_business-scheduling-v1-time-slots-time-slot-uid.md
- https://developers.intandem.tech:443/reference/delete_v3-scheduling-resource-types-uid.md
- https://developers.intandem.tech:443/reference/delete_v3-scheduling-resources-uid.md
- https://developers.intandem.tech:443/reference/get_platform-v1-scheduling-appointments-appointment-id.md
- https://developers.intandem.tech:443/reference/get_platform-v1-scheduling-appointments.md
- https://developers.intandem.tech:443/reference/get_platform-v1-scheduling-bookings.md
- https://developers.intandem.tech:443/reference/get_platform-v1-scheduling-event-attendances-event-attendance-uid.md
- https://developers.intandem.tech:443/reference/get_platform-v1-scheduling-event-instance-event-instance-id.md
- https://developers.intandem.tech:443/reference/get_platform-v1-scheduling-scheduling-forms-get-form.md
- https://developers.intandem.tech:443/reference/get_platform-v1-services-1.md
- https://developers.intandem.tech:443/reference/get_platform-v1-staff-availability.md
- https://developers.intandem.tech:443/reference/get_v3-scheduling-availability-slots.md
- https://developers.intandem.tech:443/reference/get_v3-scheduling-resource-types-uid.md
- https://developers.intandem.tech:443/reference/get_v3-scheduling-resource-types.md
- https://developers.intandem.tech:443/reference/get_v3-scheduling-resources-uid.md
- https://developers.intandem.tech:443/reference/get_v3-scheduling-resources.md
- https://developers.intandem.tech:443/reference/post_business-scheduling-v1-appointments.md
- https://developers.intandem.tech:443/reference/post_business-scheduling-v1-bookings-accept.md
- https://developers.intandem.tech:443/reference/post_business-scheduling-v1-bookings-complete.md
- https://developers.intandem.tech:443/reference/post_business-scheduling-v1-bookings.md
- https://developers.intandem.tech:443/reference/post_business-scheduling-v1-time-slots.md
- https://developers.intandem.tech:443/reference/post_platform-v1-scheduling-bookings-cancel.md
- https://developers.intandem.tech:443/reference/post_platform-v1-scheduling-bookings.md
- https://developers.intandem.tech:443/reference/post_platform-v1-scheduling-waitlist.md
- https://developers.intandem.tech:443/reference/post_v3-scheduling-resource-types.md
- https://developers.intandem.tech:443/reference/post_v3-scheduling-resources.md
- https://developers.intandem.tech:443/reference/put_business-scheduling-v1-bookings-booking-id.md
- https://developers.intandem.tech:443/reference/put_business-scheduling-v1-bookings-cancel.md
- https://developers.intandem.tech:443/reference/put_business-scheduling-v1-external-calendar-items-bulk-create.md
- https://developers.intandem.tech:443/reference/put_business-scheduling-v1-external-calendar-items-bulk-deactivate.md
- https://developers.intandem.tech:443/reference/put_business-scheduling-v1-external-calendar-items-connect.md
# --- truncated at 32 KB (33 KB total) ---
# Full source: https://artifacts.apis.io/vcita/openapi/vcita-appointments-api-openapi.yml