v1
latestOpenAPI 3.0.02026-07-26870415.2 KBappointments
Get appointment by id
Returns a single appointment by its Conduit id. Use external_id to look up full appointment details from the booking service.
get/v1/appointments/{id}
Path parameters
idstring required
Appointment id.
Example:ar77c0dy0mgdpzmqz6tesry8w184002s
Query parameters
workspace_idstring
Optional workspace override. If omitted, Conduit resolves the appointment's workspace automatically.
Example:j57demo8f8x7c9v0n2q4r6t8y1u3i5o
Response
Appointment
Example response
{
"data": {
"id": "ar77c0dy0mgdpzmqz6tesry8w184002s",
"workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
"contact_id": "ph77c0dy0mgdpzmqz6tesry8w184002s",
"external_id": "bk_vcNpA4g3iJWvlkY1",
"status": "confirmed",
"start_at": "2026-04-21T13:30:00.000Z",
"end_at": "2026-04-21T13:45:00.000Z",
"duration_ms": 900000,
"origin": "direct",
"notes": "Tour of the property, coming from Airbnb inquiry.",
"generated_context": "Guest asked about check-in flexibility.",
"short_link_id": "sl_8m3qxv2",
"strength_indicator": 0.82,
"booking_info": {
"name": "Taylor Reid",
"email": "taylor.reid@example.com",
"phone": "+14155550123",
"notes": null
},
"references": [
{
"id": "listing_456",
"type": "unit",
"value": "Unit 4B"
}
],
"last_synced_at": "2026-04-18T16:12:05.000Z",
"created_at": "2026-04-18T16:12:00.000Z"
}
}