Skip to main content
GET
/
v1
/
appointments
/
{id}
Get appointment by id
curl --request GET \
  --url https://api.conduit.ai/v1/appointments/{id} \
  --header 'Authorization: Bearer <token>'
{
  "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"
  }
}

Authorizations

​
Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Path Parameters

​
id
string
required

Appointment id.

Example:

"ar77c0dy0mgdpzmqz6tesry8w184002s"

Query Parameters

​
workspace_id
string

Optional workspace override. If omitted, Conduit resolves the appointment's workspace automatically.

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

Response

Appointment

Single appointment response.

​
data
object
required

A scheduled appointment, including status, start/end times, notes, and the contact details captured at booking time.