Skip to main content
GET
/
appointments
/
{appointment}
cURL
curl --request GET \
  --url https://api.caspen.com/v1/appointments/{appointment}
{
  "id": "<string>",
  "location_id": "<string>",
  "practitioner_id": "<string>",
  "service_id": "<string>",
  "client_id": "<string>",
  "client_package_id": "<string>",
  "case_id": "<string>",
  "starts_at": "<string>",
  "ends_at": "<string>",
  "duration": 123,
  "status": "<string>",
  "confirmed": true,
  "confirmed_at": "<string>",
  "room_id": "<string>",
  "vehicle_id": "<string>",
  "resource_ids": [
    "<string>"
  ],
  "note": "<string>",
  "cancellation_reason_id": "<string>",
  "cancellation_note": "<string>",
  "cancelled_at": "<string>",
  "created_at": "<string>"
}

Path Parameters

appointment
string
required

The appointment ID

Response

AppointmentResource

id
string

The appointment's unique identifier.

location_id
string

The location identifier where the appointment takes place.

practitioner_id
string

The practitioner identifier who provides the service.

service_id
string

The service identifier being provided.

client_id
string

The client identifier who has the appointment.

client_package_id
string | null

The client package identifier if this appointment uses a package.

case_id
string | null

The case identifier if this appointment is part of a case.

starts_at
string

The appointment start time (ISO 8601).

ends_at
string

The appointment end time (ISO 8601).

duration
integer

The appointment duration in minutes.

status
string

The appointment status.

confirmed
boolean | null

Whether the appointment is confirmed.

confirmed_at
string | null

When the appointment was confirmed (ISO 8601).

room_id
string | null

The room identifier where the appointment takes place.

vehicle_id
string | null

The vehicle identifier if transportation is involved.

resource_ids
string[]

The IDs of resources required for this appointment.

note
string | null

The appointment note.

cancellation_reason_id
string | null

The cancellation reason identifier if cancelled.

cancellation_note
string | null

The cancellation note if cancelled.

cancelled_at
string | null

When the appointment was cancelled (ISO 8601).

created_at
string

The timestamp when the appointment was created (ISO 8601).