Skip to main content
GET
/
v1
/
contacts
/
{id}
/
appointments
List appointments for a contact
curl --request GET \
  --url https://api.conduit.ai/v1/contacts/{id}/appointments \
  --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"
    }
  ],
  "next_cursor": "page-token",
  "has_more": true
}

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

Contact id.

Example:

"ph77c0dy0mgdpzmqz6tesry8w184002s"

Query Parameters

​
workspace_id
string

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

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

​
limit
integer

Page size. Defaults to 20. Max 100.

Required range: 1 <= x <= 100
​
cursor
string
​
order
enum<string>

Sort direction. Defaults to desc.

Available options:
asc,
desc
​
status
enum<string>

Filter by appointment status. Use completed, no_show, cancelled, or rescheduled to compute booking efficacy rates.

Available options:
awaiting_response,
awaiting_confirmation,
confirmed,
cancelled,
completed,
no_show,
rescheduled
​
start_after
string<date-time>

Only return appointments scheduled at or after this ISO 8601 timestamp.

​
start_before
string<date-time>

Only return appointments scheduled strictly before this ISO 8601 timestamp.

Response

Contact appointments

Cursor-paginated appointments response.

​
data
object[]
required
​
next_cursor
string | null
required
​
has_more
boolean
required